Go crypto/ecdh PrivateKey.Equal 怎样判断两把密钥是否相同

在 Go 的 crypto/ecdh 包里，如果只是想判断两把 ECDH 私钥是否表示同一把密钥，优先使用 PrivateKey.Equal，不要先把私钥转成字符串再比较。这个方法接收一个 crypto.PrivateKey，返回布尔值；当密钥类型和曲线匹配时，比较过程按常量时间执行。

直接结论：同一曲线、同一编码重建出的私钥，Equal 通常返回 true；跨曲线密钥返回 false。官方文档还特别提醒，语义上等价但编码不同的私钥可能返回 false，所以这个结果表示“编码对象是否代表同一把可比较的私钥”，不能简单理解成所有数学等价表示都相等。

PrivateKey.Equal 到底比较什么

PrivateKey.Equal(x crypto.PrivateKey) 比较的是当前 *ecdh.PrivateKey 与另一个私钥对象的身份关系。它不是指针地址比较，也不是把私钥转成可读文本后做普通字符串比较。

调用时需要关注三个输入条件：另一侧是否也是可识别的私钥类型、两把密钥使用的曲线是否匹配，以及编码是否落在 API 能直接比较的语义范围内。返回值只有 true 或 false，不要把它当作错误通道。

用同一曲线重建私钥再比较

下面的示例先用 ecdh.P256 生成一把私钥，再把它的编码交给同一条曲线的 NewPrivateKey 重建第二个私钥对象。示例只用内存中的演示密钥，不能把真实生产私钥写进日志或测试输出。

package main

import (
    "crypto/ecdh"
    "crypto/rand"
    "fmt"
)

func main() {
    // 用系统安全随机源生成演示用的 P-256 私钥。
    original, err := ecdh.P256().GenerateKey(rand.Reader)
    if err != nil {
        panic(fmt.Errorf("生成原始私钥失败: %w", err))
    }

    // Bytes 返回编码副本；这里只用于同曲线重建，不打印这些敏感字节。
    encoded := original.Bytes()
    rebuilt, err := ecdh.P256().NewPrivateKey(encoded)
    if err != nil {
        panic(fmt.Errorf("重建私钥失败: %w", err))
    }

    // Equal 判断两把私钥是否表示同一把可比较的密钥。
    fmt.Println(original.Equal(rebuilt))
}

这个例子预期输出 true。关键点是重建动作使用了同一条曲线，并且没有修改 Bytes 返回的编码。若把字节内容改坏，NewPrivateKey 会在重建阶段返回错误，程序就不应该继续比较。

跨曲线比较为什么返回 false

曲线是 ECDH 私钥身份的一部分。即使两把私钥都属于 *ecdh.PrivateKey，一把来自 P-256、另一把来自 P-384，也不应把它们当成同一把密钥。比较前可以先从业务对象里确认曲线选择，最终判断仍交给 Equal。

package main

import (
    "crypto/ecdh"
    "crypto/rand"
    "fmt"
)

func compareCurves() error {
    // 两把密钥使用不同曲线，示例只观察 Equal 的布尔语义。
    p256Key, err := ecdh.P256().GenerateKey(rand.Reader)
    if err != nil {
        return fmt.Errorf("生成 P-256 私钥失败: %w", err)
    }
    p384Key, err := ecdh.P384().GenerateKey(rand.Reader)
    if err != nil {
        return fmt.Errorf("生成 P-384 私钥失败: %w", err)
    }

    // 跨曲线不是同一把 ECDH 私钥，结果应为 false。
    fmt.Println(p256Key.Equal(p384Key))
    return nil
}

这里的 false 不是 API 报错，而是一个正常的比较结论。如果业务要求两把密钥必须属于同一条曲线，应该把曲线配置也纳入对象校验，不能只靠一个布尔值推断所有上下文。

不要用导出的私钥字节做普通调试比较

PrivateKey.Bytes 返回的是私钥编码的副本，适合在受控的序列化或恢复流程里使用，但它仍然是敏感数据。不要把返回值直接写入日志、错误消息、指标标签或截图。

如果目标只是判断两把私钥是否相同，直接调用 Equal 能避免业务代码自己处理敏感字节。还要记住官方文档给出的编码边界：存在语义上等价但编码不同的私钥时，Equal 可能返回 false；这时应先明确业务比较的是“原始编码身份”还是“协议层可用性”，不要偷偷改成字符串比较。

把判断封装成清晰的业务边界

如果比较动作出现在密钥轮换、缓存去重或配置加载流程里，可以封装成只返回布尔值的小函数，并把类型错误、曲线错误和序列化错误留在各自的上游处理。这样调用方不会误以为 false 就代表发生了系统异常。

func sameECDHKey(left, right *ecdh.PrivateKey) bool {
    // nil 不是可比较的业务密钥，先返回明确的否定结果。
    if left == nil || right == nil {
        return false
    }
    // 交给标准库处理曲线与密钥表示的比较语义。
    return left.Equal(right)
}

这个封装不负责生成密钥、保存密钥或处理轮换策略，它只把“两个对象是否表示同一把 ECDH 私钥”这个判断固定下来。调用方仍应在进入这里之前完成来源、生命周期和权限管理。

相关问题

Equal 比较的是指针地址吗？

不是。复制或重新构建出同一编码的私钥对象后，比较的是私钥表示的语义，而不是两个 Go 指针是否指向同一块内存。

为什么等价编码也可能返回 false？

官方文档明确说明，存在代表同一把密钥但编码不同的情况；Equal 的结果不应被扩大解释为所有等价编码都相等。

能否用 bytes.Equal 替代 Equal？

不建议。那会迫使业务代码导出和持有私钥字节，还会混淆编码比较与密钥语义比较。优先使用标准库提供的 Equal。