Go crypto.Hash.Available 为什么返回 false

crypto.Hash.Available() 返回 false，通常不是因为 SHA-256 之类的算法“不受 Go 支持”，而是因为对应实现包没有被导入，构造函数没有注册进当前程序，最终二进制里也就没有可供 crypto.Hash 调用的实现。crypto.SHA256 只是算法标识，不会单独把 crypto/sha256 链接进程序。

官方文档：https://pkg.go.dev/crypto

先分清算法编号和实现

crypto.Hash 的底层类型是 uint，它负责标识 MD5、SHA-256、SHA-512 等算法。真正计算摘要的代码位于 crypto/md5、crypto/sha256、crypto/sha512 等实现包。把算法编号与实现拆开，可以让签名接口只传递统一的算法标识，也让链接器不必把所有哈希实现都塞进每个二进制。

标准库内部维护一张构造函数表。实现包在初始化时调用 crypto.RegisterHash 填入对应位置；Available 本质上就是判断该位置是否已有构造函数。因此，同一个 crypto.SHA256 常量，在一个程序中可能返回 true，在另一个没有导入实现包的程序中可能返回 false。

复现未导入实现时的 false

下面的程序只导入 crypto。它能引用 crypto.SHA256，也能读取摘要长度，但没有任何代码把 SHA-256 构造函数注册进来，所以 Available 会是 false。

package main

import (
	"crypto"
	"fmt"
)

func main() {
	// SHA256 是算法标识；仅引用常量不会链接 crypto/sha256 实现。
	fmt.Println("available:", crypto.SHA256.Available())

	// Size 只读取固定摘要长度，不要求实现已经链接进程序。
	fmt.Println("size:", crypto.SHA256.Size())
}

这也解释了一个常见困惑：Size() 能返回 32，并不意味着 New() 一定可用。官方文档明确说明，Size 不要求实现已链接；而 New 在实现不可用时会 panic。

导入实现包会触发注册

crypto/sha256 的初始化函数会分别为 crypto.SHA224 和 crypto.SHA256 调用 crypto.RegisterHash。只要程序真实导入该包，它就会参与构建，并在启动阶段完成注册。

package main

import (
	"crypto"
	_ "crypto/sha256" // 只为执行 init 注册 SHA-224 和 SHA-256 实现。
	"fmt"
)

func main() {
	// 注册完成后，泛型 crypto.Hash API 可以创建 SHA-256 实例。
	fmt.Println("available:", crypto.SHA256.Available())
	h := crypto.SHA256.New()
	_, _ = h.Write([]byte("hello")) // hash.Hash 的 Write 不返回业务错误。
	fmt.Printf("digest: %x\n", h.Sum(nil))
}

空白导入适合插件式或按配置选择算法的代码，因为调用方只持有 crypto.Hash。如果程序本来就直接调用 sha256.New 或 sha256.Sum256，普通导入已经会执行同一个初始化逻辑，不需要再写空白导入。

按使用方式选择修复

算法固定时，优先使用实现包的直接 API。代码更直观，也不会出现“有算法编号但实现未注册”的歧义。只有算法来自配置、证书、协议协商或签名选项时，才需要用 crypto.Hash 做泛型分发。

package digest

import "crypto/sha256"

func Sum(data []byte) [sha256.Size]byte {
	// 算法固定时直接调用实现包，编译器会把所需实现链接进二进制。
	return sha256.Sum256(data)
}

运行时选择算法时，应先检查 Available，再创建实例，并把不可用状态转换成普通错误交给上层处理。不要依赖 recover 把 New 的 panic 当作正常分支。

package digest

import (
	"crypto"
	_ "crypto/sha256" // 注册本服务允许的算法实现。
	_ "crypto/sha512"
	"fmt"
)

func SumWith(h crypto.Hash, data []byte) ([]byte, error) {
	// 先确认当前二进制确实包含实现，避免 h.New() 触发 panic。
	if !h.Available() {
		return nil, fmt.Errorf("hash implementation unavailable: %s", h)
	}

	digest := h.New()
	_, _ = digest.Write(data) // 标准 hash.Hash 写入内存数据不会返回错误。
	return digest.Sum(nil), nil
}

处理 panic 和特殊常量

并非 crypto.Hash 中每个常量都对应可注册实现。例如 MD5SHA1 在常量注释中说明没有实现，它是 TLS RSA 的组合值；新版本中的 MLDSAMu 也是预哈希消息代表值，不允许通过 RegisterHash 注册。这类值不是导入某个包就能让 Available 变成 true。

自定义代码通常也不应调用 crypto.RegisterHash 去覆盖标准算法。这个函数主要供实现哈希函数的包在 init 中注册构造器。业务层要做的是明确允许的算法集合，导入相应实现，并在泛型入口检查可用性。

常见问题

空白导入 crypto/sha256 是不是副作用导入？

是。它的目的就是让包的 init 执行并注册构造函数。固定算法代码更适合直接调用 sha256.New 或 sha256.Sum256，泛型算法注册场景才需要空白导入。

为什么导入 crypto/rsa 不能让 SHA-256 可用？

crypto/rsa 实现 RSA 算法，不负责注册 SHA-256 哈希构造函数。仍需导入 crypto/sha256，或者由其他依赖真实导入它。

依赖包间接导入 sha256 可以吗？

当前构建中只要有可达依赖导入并初始化 crypto/sha256，注册就会发生。但业务代码不应依赖偶然的传递导入；如果这是你的功能前提，应在负责算法集合的包中显式导入。

Available 为 false 时能否直接调用 New 再 recover？

不建议。不可用是可预期状态，先检查并返回普通错误更清晰。recover 应留给真正需要隔离未知 panic 的边界，不应替代正常条件判断。