Go crypto/sha256.New 为什么 Sum 之后仍能继续写入同一个哈希对象
我第一次排查“摘要怎么和另一端对不上”时,误以为调用 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,不能写入摘要结果。
Go crypto/sha256.New 怎样用 New 对长数据做流式 SHA-256
- 上一篇
- Go crypto/sha256.New 怎样用 New 对长数据做流式 SHA-256
- 下一篇
- Go crypto/sha512.New 怎样为长输入选择 SHA-512 流式哈希
-
- Golang · Go问答 | 11分钟前 | 标准库 · TLS · 密码学 · Go问答 · tls Go crypto/x509 X.509 CreateCertificate KeyUsage ExtKeyUsage
- Go crypto/x509.CreateCertificate 为什么证书模板的 KeyUsage 会影响客户端验证
- 241浏览 收藏
-
- Golang · Go问答 | 19分钟前 | go ·
- Go crypto/x509.ParsePKCS8PrivateKey 为什么 ParsePKCS8PrivateKey 返回 interface 需要类型断言
- 298浏览 收藏
-
- Golang · Go问答 | 22分钟前 | 标准库 · 密码学 · Go问答 · Go SHA-256 crypto/sha512 SHA-512/256 sha512.New SHA-512
- Go crypto/sha512.New 为什么 SHA-512 输出长度不能按 SHA-256 方式截取
- 322浏览 收藏
-
- Golang · Go问答 | 33分钟前 | 标准库 · 随机数 · 密码学 · Go问答 · Go crypto/rand 素数 prime 位数 Bits rand.Prime 密码学参数
- Go crypto/rand.Prime 为什么 Prime 的位数参数不能过小
- 248浏览 收藏
-
- Golang · Go问答 | 1小时前 | 标准库 · 错误处理 · 密码学 · Go问答 · Go 密钥交换 crypto/ecdh X25519 共享秘密 PrivateKey.ECDH
- Go crypto/ecdh.PrivateKey.ECDH 为什么 ECDH 失败时不能把返回字节当作密钥
- 368浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · Go crypto/ecdh NewPublicKey 公钥编码
- Go crypto/ecdh.NewPublicKey 为什么公钥字节长度错误会直接返回错误
- 306浏览 收藏
-
- Golang · Go问答 | 1小时前 | 标准库 · 密码学 · Go问答 · Go 安全编程 crypto/subtle ConstantTimeSelect 常数时间
- Go crypto/subtle.ConstantTimeSelect 为什么 Select 的输入不能直接替代任意分支逻辑
- 227浏览 收藏
-
- Golang · Go问答 | 1小时前 | 并发 · 标准库 · 密码学 · Go问答 · Go Goroutine crypto/subtle WithDataIndependentTiming 数据无关时序 并发生命周期
- Go crypto/subtle.WithDataIndependentTiming 跨 goroutine 时序继承的生命周期处理
- 353浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1134次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1116次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1294次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1234次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1087次使用
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Golang标准库unsafe源码解读
- 2022-12-29 464浏览
-
- 快速掌握Go语言HTTP标准库的实现方法
- 2022-12-30 327浏览
-
- 解析golang 标准库template的代码生成方法
- 2022-12-24 349浏览

