Node.js crypto模块7.x与8.x版本中Buffer.toString()结果不一致问题咨询

我之前在Windows 10上用nvm管理Node.js版本时，正好碰到过和你一样的情况——用crypto模块生成哈希后，Node.js 7.x和8.x里Buffer.toString('utf-8')的输出表现差异明显。

先贴一下当时测试的示例代码：

let crypto = require('crypto');
let t1 = crypto.createHash('sha256').update('abcdefghijklmnopqrs1@0', 'utf8').digest();
console.log(t1);
console.log(t1.toString('utf-8'));

在Node.js v7.7.3里的输出是这样的：

return (<Buffer ab 7e fe cb 51 e4 3b 3e 2c 53 94 86 bd 64 f0 4d e3 99 7c ff 98 d7 9a 38 8f ac 97 e2 c1 f0 94 0a>
�~��Q...
)

问题根源 #

其实这不是crypto模块的异常，核心原因是Node.js在v8.x版本中调整了Buffer.toString('utf-8')对无效UTF-8字节的处理逻辑：

• 在v7.x及更早版本中，遇到无法解析为UTF-8的字节时，会直接输出对应的乱码字符（就是你看到的�~��Q...这类）；
• 从v8.x开始，Node.js遵循了更严格的UTF-8规范，对所有无效字节序列统一替换成�（U+FFFD替换字符），所以输出会变成一串统一的替换符号，和v7.x的乱码表现完全不同。

解决建议 #

1. 优先使用稳定编码格式：如果只是需要哈希值的可读形式，强烈建议用toString('hex')或者toString('base64')，这两种编码在所有Node.js版本里的表现都是一致的，不会出现版本差异：

   console.log(t1.toString('hex')); // 输出: ab7efecb51e43b3e2c539486bd64f04de3997cff98d79a388fac97e2c1f0940a
   

2. 兼容版本处理：如果业务场景确实需要处理UTF-8格式的Buffer，要明确代码对无效字节的预期，要么统一用v8+的严格处理逻辑，要么在低版本中手动模拟替换无效字节的行为，避免跨版本出现不一致。

内容的提问来源于stack exchange，提问作者Theocat