Node.js crypto.createHmac计算含转义斜杠字符串的HMAC结果与PHP不一致问题
Node.js 跨栈HMAC-SHA256校验结果不匹配问题解决
问题场景
在使用Node.js crypto模块的createHmac方法完成HMAC-SHA256字符串校验时,会出现同逻辑PHP环境计算结果一致、Node.js环境结果不匹配的问题,直接导致Netatmo Webhook回调验签流程失败。
对照测试记录
PHP端测试代码与结果
$jsonData = '"face_url":"https://"'; echo($jsonData); echo("\n"); $client_secret = 'kqm6FksaIT'; echo hash_hmac("sha256", $jsonData, $client_secret);
运行输出:
"face_url":"https://" 34a4eb09a639c9b80713158ae89e7e8311586e6e6d76e09967f4e42a24759b3e
Node.js端测试代码与结果
const crypto = require('crypto'); const str = '"face_url":"https://"'; console.log(str); const hashBuf = crypto.createHmac('sha256','kqm6FksaIT').update(str); const result = hashBuf.digest('hex'); console.log(result);
运行输出:
"face_url":"https://" eb502c4711a6d926eeec7830ff34e021ed62c91e574f383f6534fdd30857a907 => 校验失败
问题根因
跨端字符串字面量的解析逻辑差异是导致结果不匹配的核心:
- PHP单引号包裹的字符串仅会对单引号、反斜杠两类字符做转义处理,字符串内的
/序列会被完整保留,实际参与计算的字符串内容为"face_url":"https://" - Node.js的字符串字面量解析逻辑会自动将转义序列
/解析为单个斜杠,最终参与计算的字符串内容为"face_url":"https://"
两端入参内容存在本质差异,最终计算出的哈希值自然无法匹配。
此前验证测试也确认了该判断:如果待处理字符串不含上述转义斜杠,两端计算结果可完全一致;此前尝试的Buffer.from指定编码、JSON.stringify/JSON.parse二次处理字符串等方案,均未从根因上解决字符串内容不一致的问题。
可对齐结果的实现方案
核心思路:确保Node.js端参与HMAC计算的字符串字节内容,与PHP端入参完全一致
具体调整点:
- 对需要保留的反斜杠做二次转义,抵消JS的自动转义解析效果:JS代码中需要表达含反斜杠的字符串时,需将反斜杠本身做转义处理,如将
https://调整写法为https:\\/,JS解析后生成的实际字符串内容即可与PHP端单引号定义的字符串完全一致 - 调整后的Node.js可运行代码如下:
const crypto = require('crypto'); // 二次转义反斜杠,对齐PHP端字符串的实际内容 const str = '"face_url":"https:\\/"'; console.log(str); const hashResult = crypto.createHmac('sha256', 'kqm6FksaIT') .update(str, 'utf8') .digest('hex'); console.log(hashResult); - 调整后运行输出可完全匹配PHP端结果:
"face_url":"https://" 34a4eb09a639c9b80713158ae89e7e8311586e6e6d76e09967f4e42a24759b3e
针对Netatmo Webhook验签场景,不要对平台推送的原始请求体做转义、序列化/反序列化的二次加工,直接以原始请求体的Buffer内容作为HMAC计算入参,即可对齐官方PHP版参考实现的计算逻辑,避免验签失败。
内容的提问来源于stack exchange,提问作者Xavier Badot
相关产品推荐
相关产品推荐

