接口文档只写「上传文件时附带 SHA-256」,两个客户端各自实现:一个发出 64 字符,一个发出 44 字符。接收端直接字符串比较,结果签不一致。出问题的可能是输出约定,而非输入内容或算法。

在 文本哈希计算 填 abc,不加空格,关注 SHA256 那一行。先选 Hexadecimal,再切到 Base64。文件中保存的原始 32 字节可以用两种形式表示:Hex 每字节两字符,所以共 64;Base64 按三字节为一组,这里含填充是 44 个字符。页面输出和本机 Node 的 crypto 结果相同。

SHA256 一行以 Hex 表示,输出 64 字符
SHA256 一行以 Hex 表示,输出 64 字符
切换 Base64 后输出 44 字符,结尾带填充
切换 Base64 后输出 44 字符,结尾带填充
本机对照两种输出格式,解码后均得到相同的 32 字节
本机对照两种输出格式,解码后均得到相同的 32 字节

比较之前先还原摘要字节

在本机可直接运行这段示例。digest() 无参数时返回原始 Buffer;分别编码成 Hex 和 Base64 之后,再各按自己的格式还原。

const {createHash} = require('node:crypto');
const digest = createHash('sha256').update('abc', 'utf8').digest();
const hex = digest.toString('hex');
const b64 = digest.toString('base64');
console.log(hex.length, b64.length);
console.log(Buffer.from(hex, 'hex').equals(Buffer.from(b64, 'base64')));

常见错误是把 64 个十六进制字符当普通文本,再送进 Base64 转换。这样编码的是 64 个字符的文本,跟把原始 32 字节编码成 Base64 不是一回事。做接口联调时,把算法写成 SHA-256,输入字节约定写清楚,再指定摘要究竟用小写 Hex、标准 Base64,还是 URL 安全的 Base64url 及其填充规则。若解码后的摘要也不同,再回头比较源文件字节、字符编码和换行。也要区分原始字节比较与文本验证:如果接口要求的是固定长度的小写 Hex,应先检查字符表和长度,再解码。宽松解码器可能接受一些非规范输入,不能把「能解码」当成「符合接口契约」。