Go crypto/sha256.New 为什么 Sum 之后仍能继续写入同一个哈希对象
来源:17golang原创
时间:2026-11-20 03:42:07 323浏览 收藏
我第一次排查“摘要怎么和另一端对不上”时,误以为调用 Sum(nil) 就等于把哈希对象“结算”了。实际上,crypto/sha256.New 返回的是一个仍可继续接收输入的 hash.Hash;Sum(b) 只是把当前摘要追加到 b 后返回,既不会清空累计状态,也不会让对象失效。
官方文档:https://pkg.go.dev/crypto/sha256#New
所以,Sum 之后继续 Write,得到的是“原输入加新输入”的摘要。真正要重新开始一条哈希流,要调用 Reset,或者为另一项任务创建新的 sha256.New()。
- Sum 是读取当前摘要:它返回摘要字节,不消费对象。
- Write 仍会累计:后续输入会接在原哈希状态之后。
- Reset 才是清空:并发或多任务场景不要无保护地共享同一个对象。
为什么 Sum 之后还能继续 Write
hash.Hash 同时提供 Write、Sum 和 Reset。可以把它理解为一个持续接收字节的状态对象:Write 更新内部状态,Sum 把当前结果复制出来,Reset 才把状态恢复到初始值。
这里还有一个容易忽略的细节:Sum(b) 不一定从空切片开始。它会把摘要追加到传入的 b 后面,因此返回值可能是“前缀 + 32 字节 SHA-256 摘要”。这也是为什么应把返回值当作输出切片,而不是当作哈希对象本身。

我在分块输入里采用的写法
文件、网络响应或消息流通常不会一次性放进内存。每次写入一块数据后,可以临时读取一次摘要做日志或进度记录,再继续写入;最终摘要仍取决于完整且有序的输入。
package main
import (
"crypto/sha256"
"fmt"
)
func main() {
h := sha256.New()
// 分块写入同一条输入流,错误必须在每次 Write 后处理。
if _, err := h.Write([]byte("header|")); err != nil {
panic(err)
}
// Sum 只读取当前摘要,不会让 h 失效。
checkpoint := h.Sum(nil)
fmt.Printf("中间摘要:%x\n", checkpoint)
// 继续写入后,h 表示 header|body 的累计状态。
if _, err := h.Write([]byte("body")); err != nil {
panic(err)
}
final := h.Sum(nil)
fmt.Printf("最终摘要:%x\n", final)
}
这段代码里,checkpoint 和 final 是两个时点的输出;它们不会反过来改变 h。如果业务要比较“只有 header”和“header 加 body”两种独立结果,应分别创建两个哈希对象,而不是把一个对象在多个任务之间来回交给不同调用方。
生产代码要守住的对象边界
在生产服务里,我更在意的不是“能不能继续写”,而是对象到底归谁。把一个 hash.Hash 放进全局变量、连接池或多个 goroutine 共享,容易把不同请求的字节拼到一起;即使每次都调用 Sum(nil),也只是读取错误的累计状态。
更稳妥的约定是:一次文件、一次消息或一次请求对应一个哈希对象;任务结束后只向外返回摘要字节。需要复用同一个对象时,先确认所有权已经回收,再调用 Reset,并确保没有并发读写。摘要字节也不要当作可变的“工作区”继续写入,它只是结果。

摘要不一致时先查这四件事
- 输入是否完全一致:大小写、换行、字符编码和末尾空白都属于摘要输入。
- 是否在错误的位置调用了 Sum:Sum 只取当前时点;过早读取不会自动包含后续字节。
- 是否误用了前缀:比较结果时确认
Sum(nil)与Sum(prefix)的返回布局不同。 - 是否复用了旧对象:跨请求或跨文件时要新建对象,或在明确无并发的所有权边界内 Reset。
我的经验是,先打印输入长度和分块顺序,再检查对象生命周期,最后才怀疑 SHA-256 本身。只要输入序列一致,Sum 不会因为被调用过一次就改变后续摘要的计算规则。
常见问题
调用 Sum 后需要重新 New 吗?不需要。要继续同一条输入流就直接 Write;要开启新流才 Reset 或 New。
Sum(nil) 返回的是哈希对象吗?不是,它是摘要字节切片。后续输入必须写入原来的 hash.Hash,不能写入摘要结果。
-
369 收藏
-
344 收藏
-
464 收藏
-
327 收藏
-
349 收藏
-
Golang · Go问答 | 11分钟前 | 标准库 · TLS · 密码学 · Go问答 · tls Go crypto/x509 X.509 CreateCertificate KeyUsage ExtKeyUsage241 收藏
-
298 收藏
-
322 收藏
-
248 收藏
-
Golang · Go问答 | 50分钟前 | 标准库 · 测试 · 随机数 · Go问答 · Go crypto/rand 随机字符串 io.Reader 可复现测试 Base32 rand.Text111 收藏
-
368 收藏
-
306 收藏
-
464 收藏
-
227 收藏
-
Golang · Go问答 | 1小时前 | 并发 · 标准库 · 密码学 · Go问答 · Go Goroutine crypto/subtle WithDataIndependentTiming 数据无关时序 并发生命周期353 收藏
-
383 收藏
-
241 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习