当前位置:首页 > 文章列表 > Golang > Go问答 > Go crypto/sha256.New 为什么 Sum 之后仍能继续写入同一个哈希对象

Go crypto/sha256.New 为什么 Sum 之后仍能继续写入同一个哈希对象

来源:17golang原创 2026-11-20 03:42:07 0浏览 收藏

我第一次排查“摘要怎么和另一端对不上”时,误以为调用 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 摘要”。这也是为什么应把返回值当作输出切片,而不是当作哈希对象本身。

sha256.New、hash.Hash、Write、Sum 和摘要输出之间的静态关系说明图
图1:结构说明图,展示 Sum 读取当前摘要但不消费 hash.Hash 状态的关系,不是截图或运行证据。

我在分块输入里采用的写法

文件、网络响应或消息流通常不会一次性放进内存。每次写入一块数据后,可以临时读取一次摘要做日志或进度记录,再继续写入;最终摘要仍取决于完整且有序的输入。

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,并确保没有并发读写。摘要字节也不要当作可变的“工作区”继续写入,它只是结果。

hash.Hash 的 Sum、Reset、独立 New 与共享复用风险边界说明图
图2:关系说明图,对比摘要读取、重置和独立对象之间的生产边界,不是运行结果截图。

摘要不一致时先查这四件事

  1. 输入是否完全一致:大小写、换行、字符编码和末尾空白都属于摘要输入。
  2. 是否在错误的位置调用了 Sum:Sum 只取当前时点;过早读取不会自动包含后续字节。
  3. 是否误用了前缀:比较结果时确认 Sum(nil) 与 Sum(prefix) 的返回布局不同。
  4. 是否复用了旧对象:跨请求或跨文件时要新建对象,或在明确无并发的所有权边界内 Reset。

我的经验是,先打印输入长度和分块顺序,再检查对象生命周期,最后才怀疑 SHA-256 本身。只要输入序列一致,Sum 不会因为被调用过一次就改变后续摘要的计算规则。

常见问题

调用 Sum 后需要重新 New 吗?不需要。要继续同一条输入流就直接 Write;要开启新流才 Reset 或 New。

Sum(nil) 返回的是哈希对象吗?不是,它是摘要字节切片。后续输入必须写入原来的 hash.Hash,不能写入摘要结果。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go crypto/sha256.New 怎样用 New 对长数据做流式 SHA-256Go crypto/sha256.New 怎样用 New 对长数据做流式 SHA-256
上一篇
Go crypto/sha256.New 怎样用 New 对长数据做流式 SHA-256
Go crypto/sha512.New 怎样为长输入选择 SHA-512 流式哈希
下一篇
Go crypto/sha512.New 怎样为长输入选择 SHA-512 流式哈希
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1134次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1116次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1294次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1234次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1087次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码