You need to enable JavaScript to run this app. Node.js crypto.createHmac计算含转义斜杠字符串的HMAC结果与PHP不一致问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 11:06:04