本文详解如何在 Go 中正确计算用户密码的 SHA256 哈希值并进行标准 Base64 编码，重点纠正常见的 hash.Sum() 误用问题，确保输出格式符合 {SHA256}base64-encoded-digest 规范。
本文详解如何在 go 中正确计算用户密码的 sha256 哈希值并进行标准 base64 编码，重点纠正常见的 `hash.sum()` 误用问题，确保输出格式符合 `{sha256}base64-encoded-digest` 规范。
在构建符合特定认证协议（如 TopCoder 简单 API 服务器挑战）的后端服务时，常需将用户密码按固定格式加密存储：前缀 {SHA256} 后紧跟 原始 SHA256 哈希字节的 Base64 编码结果（注意：不是对哈希字符串的编码，而是对 32 字节哈希值的直接编码）。初学者易因混淆 hash.Hash.Sum() 的语义而得到错误结果——例如输入 "abcd1234" 时输出 {SHA256}YWJjZDEyMzTjsMRCmPwcFJr79MiZb7kkJ65B5GSbk0yklZkbeFK4VQ==，这实为对 []byte("abcd1234") 的错误拼接编码，而非真正的 SHA256 摘要。
根本原因在于误用了 sha256.New().Sum([]byte(password))：Sum(b) 的作用是将当前哈希值追加到切片 b 末尾并返回新切片，而非“以 b 作为输入计算哈希”。因此 h.Sum([]byte(password)) 实际等价于 append([]byte("abcd1234"), hashBytes...)，导致 Base64 编码对象是拼接后的混合字节，完全偏离预期。
✅ 正确做法有两种等效方式：
方式一：使用 hash.Write() + Sum(nil)
先写入密码字节，再调用 Sum(nil) 获取独立哈希字节切片（nil 表示不复用任何底层数组）：
import (
"crypto/sha256"
"encoding/base64"
)
func encryptPassword(password string) string {
h := sha256.New()
h.Write([]byte(password)) // ✅ 关键：先写入数据
digest := h.Sum(nil) // ✅ 返回独立的 []byte，长度 32
encoded := base64.StdEncoding.EncodeToString(digest)
return "{SHA256}" + encoded
}
方式二：使用 sha256.Sum256()（更简洁、零分配）
该函数直接返回一个包含哈希值的结构体，其 [:] 可转为 []byte：
func encryptPassword(password string) string {
sum := sha256.Sum256([]byte(password)) // ✅ 一行完成哈希计算
encoded := base64.StdEncoding.EncodeToString(sum[:])
return "{SHA256}" + encoded
}
验证示例：
对输入 "abcd1234"，两种方式均输出：
{SHA256}6c7nGrky_ehjM40Ivk3p3-OeoEm9r7NCzmWexUULaa4=
（注意：Base64 中的 _ 和 - 是标准 StdEncoding 的合法字符，与 URL 安全编码 URLEncoding 不同）
⚠️ 注意事项：
- 切勿在 Sum() 中传入非 nil 的切片用于“输入”，它仅用于追加；
- sha256.New() 返回的是 hash.Hash 接口，必须显式 Write()；
- 生产环境切勿直接哈希明文密码——应使用加盐（salt）和迭代的密钥派生函数（如 bcrypt、scrypt 或 Argon2），本例仅为满足特定格式要求的教学场景；
- Base64 编码必须使用 base64.StdEncoding（非 URLEncoding），否则字符集不匹配。
总结：Go 的哈希接口设计强调流式写入与显式计算分离。掌握 Write() → Sum(nil) 的标准流程，或选用 Sum256() 这类便捷函数，是避免此类低级但致命错误的关键。
