NodeJS MD5哈希代码转PHP等价实现求助（含测试案例）

我之前迁移代码时也碰到过这个一模一样的坑！问题核心出在字符串编码的处理差异上：NodeJS里的new Buffer(str, 'binary')是把字符串按单字节的Latin-1（ISO-8859-1）规则处理，而PHP默认的md5()函数是按当前脚本的编码（通常是UTF-8）来处理字符串的——这就导致中文这类多字节字符被拆成了不同的字节序列，最终哈希结果自然不一致。

对应的PHP等价实现 #

针对你给出的测试输入42b86318d761e13ef90c126c3e060582陇3陇724039陇1，可以用以下PHP代码得到和NodeJS完全一致的MD5结果：

// 假设你的输入字符串是UTF-8编码（大部分场景都是）
$str = '42b86318d761e13ef90c126c3e060582陇3陇724039陇1';

// 将UTF-8字符串转换为Latin-1编码，对应NodeJS的'binary'处理逻辑
$latin1EncodedStr = mb_convert_encoding($str, 'ISO-8859-1', 'UTF-8');

// 计算MD5哈希
$md5_result = md5($latin1EncodedStr);

echo $md5_result; // 输出：9860bd2248c069c7b65045917c215596

为什么这样能解决问题？ #

NodeJS的binary编码其实是个历史遗留的别名，它的实际行为是：把字符串中每个字符的UTF-16码点的低8位提取出来，作为单字节处理。这和ISO-8859-1编码的规则完全匹配——ISO-8859-1每个字符对应一个字节，码点范围0-255。

比如你输入里的中文"陇"，UTF-8编码是三个字节0xE9 0x99 0x87：

• NodeJS用binary处理时，会直接把这三个字节当作哈希的输入
• PHP如果直接用md5($str)，会把这三个字节当作UTF-8字符处理，最终计算的字节序列和NodeJS不同
• 转成Latin-1后，这三个字节会被完整保留，和NodeJS的输入字节序列完全一致，所以哈希结果就匹配了

额外注意事项 #

如果你的PHP脚本默认编码不是UTF-8，记得把mb_convert_encoding的第三个参数改成字符串的实际编码（比如GBK），才能保证转换准确。

内容的提问来源于stack exchange，提问作者Alexander Nuñez