Go sha256.New224 怎样计算 SHA-224 摘要

我在给文件指纹做协议字段时，最容易看错的不是 sha256.New224() 的调用，而是它最后返回多少字节。New224 创建的是计算 SHA-224 的 hash.Hash，摘要原始长度是 28 字节；如果用十六进制输出，就是 56 个字符。只要把这两个数字先记住，很多“结果长度不对”的排查会快很多。

官方地址：https://pkg.go.dev/crypto/sha256#New224

需要分段写入、文件输入或网络流时用 sha256.New224()；手头已经有完整的 []byte 时，可以直接用 sha256.Sum224。两者计算的是同一个 SHA-224 摘要，区别在输入形态和返回值。

先把摘要长度认准

crypto/sha256 包同时提供 SHA-224 和 SHA-256。官方文档中，Size224 是 28，Size 是 32；因此 SHA-224 的二进制摘要是 28 字节，经过 %x 或 hex.EncodeToString 展示后会变成 56 个十六进制字符。

package main

import (
	"crypto/sha256"
	"encoding/hex"
	"fmt"
)

func main() {
	h := sha256.New224()
	// New224 返回 hash.Hash，输入可以分多次写入。
	_, _ = h.Write([]byte("hello"))
	_, _ = h.Write([]byte(" world"))

	sum := h.Sum(nil)
	// SHA-224 是 28 字节；十六进制字符串因此是 56 个字符。
	fmt.Println(len(sum), len(hex.EncodeToString(sum)))
	fmt.Println(hex.EncodeToString(sum))
}

这里的 Sum(nil) 会返回当前摘要的字节切片。hash.Hash 的接口约定是把摘要追加到传入的切片，并且不会改变哈希状态，所以同一个状态可以在需要时再次读取摘要。

用 New224 处理分段输入

实际项目里，输入经常不是一个完整字符串：配置内容可能分块到达，文件也不适合先全部读入内存。此时先创建一次哈希对象，再把每一段数据写入即可。不要在每个分片上重新调用 New224，否则得到的是多个独立摘要，而不是整个输入的摘要。

func sha224Parts(parts [][]byte) ([]byte, error) {
	h := sha256.New224()
	for _, part := range parts {
		// 空分片不会改变摘要，但保留统一的写入路径。
		if _, err := h.Write(part); err != nil {
			// hash.Hash 的标准实现不会返回写入错误，接口仍要求处理返回值。
			return nil, err
		}
	}
	// Sum(nil) 取出当前状态的 28 字节摘要。
	return h.Sum(nil), nil
}

我通常会把“创建哈希对象”和“写入所有输入”放在同一个小函数里，调用方只接收最终摘要。这样不容易把某个分片遗漏，也能明确摘要边界到底覆盖哪些数据。

文件输入不要先整体读入内存

文件摘要是 New224 很典型的使用场景。打开文件后把内容复制到哈希对象，最后再取摘要；io.Copy 会沿着 io.Reader 读取，不需要构造一个与文件同样大小的字节切片。

func sha224File(name string) ([]byte, error) {
	f, err := os.Open(name)
	if err != nil {
		// 打开失败通常是路径、权限或文件不存在，原样交给调用方。
		return nil, err
	}
	defer f.Close()

	h := sha256.New224()
	// io.Copy 把文件流写入哈希对象，避免一次性加载完整文件。
	if _, err := io.Copy(h, f); err != nil {
		return nil, err
	}
	// 文件关闭由 defer 负责，摘要读取不改变哈希状态。
	return h.Sum(nil), nil
}

这个函数需要补齐 crypto/sha256、io 和 os 的导入。文件很小也可以一次性读入，但流式写法的边界更清楚，后续换成网络响应或管道时也不需要改摘要逻辑。

New224 和 Sum224 怎么选

如果输入已经完整地放在 []byte 中，sha256.Sum224(data) 更直接，它返回一个长度为 sha256.Size224 的数组。若输入会持续到达，或者需要通过 io.Reader 处理文件，使用 New224 返回的 hash.Hash 更合适。

func sha224Bytes(data []byte) string {
	sum := sha256.Sum224(data)
	// Sum224 返回数组，%x 可以直接按十六进制展开。
	return fmt.Sprintf("%x", sum)
}

func sha256Bytes(data []byte) string {
	sum := sha256.Sum256(data)
	// 这里是 SHA-256，对应 32 字节和 64 个十六进制字符。
	return fmt.Sprintf("%x", sum)
}

摘要结果不对时按这几项排查

遇到接口校验失败或文件指纹对不上时，我会先检查输入边界，再检查输出表达方式。最常见的问题不是哈希函数坏了，而是两端使用了不同的算法、不同的字节序列或不同的编码展示。

• 长度是 64 个十六进制字符：先确认是不是误用了 sha256.New 或 Sum256。
• 长度是 28：这通常是把原始摘要字节直接当成文本展示；需要文本时再用 hex.EncodeToString 或 %x。
• 同一输入结果不同：检查是否多写了换行、空格、编码头或文件尾字节。
• 分片结果不一致：确认所有分片写入同一个 hash.Hash，没有在循环中反复创建 New224。
• 输入为空：空输入也有确定的 SHA-224 摘要，不能把“输入长度为零”误认为“摘要无效”。

一份可复用的检查清单

1. 需要流式输入时只创建一次 sha256.New224()。
2. 用 Write 写入所有字节，摘要边界中不要悄悄添加换行。
3. 用 h.Size() 或 sha256.Size224 确认原始结果应为 28 字节。
4. 跨系统传递文本摘要时统一使用 56 个十六进制字符。
5. 完整 []byte 输入优先考虑 sha256.Sum224，不要为了短数据强行维护流式对象。

一句话总结：sha256.New224 解决的是“持续把字节写入 SHA-224 状态”，最终得到 28 字节摘要；输出成十六进制后是 56 个字符。先确认算法和输入边界，再检查展示编码，排查就不会只盯着最后一行字符串。

相关问题

New224 和 New 的主要区别是什么？

New224 计算 SHA-224，结果为 28 字节；New 计算 SHA-256，结果为 32 字节。

为什么 Sum(nil) 不会把哈希状态清空？

hash.Hash 的 Sum 只是把当前摘要追加到目标切片，不会改变底层状态。需要重新开始计算时要显式调用 Reset，或者创建新的哈希对象。

SHA-224 摘要可以直接当作字符串吗？

原始摘要是二进制字节，通常先用十六进制或 Base64 编码成文本；不要直接把任意二进制结果当作 UTF-8 字符串。