登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

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 摘要”。这也是为什么应把返回值当作输出切片,而不是当作哈希对象本身。

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删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>