如何将Java HMAC签名逻辑转换为Node.js实现？

核心差异分析 #

你的Node.js代码和厂商Java代码的关键潜在差异在于字符串转字节数组的编码方式：

• Java中String.getBytes()不传参数时，使用的是系统平台默认编码（比如Windows是GBK，Linux/macOS是UTF-8），而非固定UTF-8
• 你当前Node.js代码强制使用UTF-8编码，这大概率是签名不匹配的根源

另外，Hex字符串转换逻辑是一致的：Java的bytesToHexString转小写，Node.jsdigest('hex')默认也输出小写，这部分无需调整。

分步解决方案 #

1. 先验证编码一致性 #

用相同的测试值分别运行Java和Node.js代码，确认编码差异：

Java测试代码（添加编码显式声明）

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

public class HmacTest {
    public static void main(String[] args) throws Exception {
        String clientSecret = "testSecret";
        String strToSign = "testString";
        
        // 先测试UTF-8编码的情况
        var signingKeyUtf8 = new SecretKeySpec(clientSecret.getBytes("UTF-8"), "HmacSHA256");
        var macUtf8 = Mac.getInstance("HmacSHA256");
        macUtf8.init(signingKeyUtf8);
        String signedStrUtf8 = bytesToHexString(macUtf8.doFinal(strToSign.getBytes("UTF-8")));
        System.out.println("UTF-8签名结果：" + signedStrUtf8);
        
        // 再测试平台默认编码的情况（模拟厂商原始代码）
        var signingKeyDefault = new SecretKeySpec(clientSecret.getBytes(), "HmacSHA256");
        var macDefault = Mac.getInstance("HmacSHA256");
        macDefault.init(signingKeyDefault);
        String signedStrDefault = bytesToHexString(macDefault.doFinal(strToSign.getBytes()));
        System.out.println("默认编码签名结果：" + signedStrDefault);
    }

    private static String bytesToHexString(byte[] bytes) {
        if (bytes == null) {
            return null;
        }
        StringBuilder sb = new StringBuilder();
        for (byte b : bytes) {
            String hv = String.format("%02x", b);
            sb.append(hv);
        }
        return sb.toLowerCase();
    }
}

Node.js测试代码

const crypto = require('crypto');

const clientSecret = "testSecret";
const strToSign = "testString";

// UTF-8编码测试
const signedStrUtf8 = crypto
  .createHmac('SHA256', Buffer.from(clientSecret, "utf8"))
  .update(strToSign, "utf8")
  .digest('hex');
console.log("UTF-8签名结果：", signedStrUtf8);

如果两者UTF-8结果一致，但默认编码结果不同，说明厂商代码用的是平台默认编码，需要在Node.js中匹配该编码。

2. 匹配厂商的编码方式 #

如果厂商使用的是非UTF-8编码（比如GBK），Node.js需要借助第三方库处理：

1. 安装编码处理库

npm install iconv-lite

2. 修改Node.js代码对应编码（以GBK为例）

const crypto = require('crypto');
const iconv = require('iconv-lite');

// 将字符串转为厂商使用的编码的Buffer
const secretBuffer = iconv.encode(clientSecret, 'gbk');
const strToSignBuffer = iconv.encode(strToSign, 'gbk');

const signedStr = crypto
  .createHmac('SHA256', secretBuffer)
  .update(strToSignBuffer)
  .digest('hex');

3. 其他排查点 #

如果编码调整后仍不匹配，检查以下细节：

• 字符串内容一致性：clientSecret和strToSign是否和Java端完全一致（包括前后空格、转义字符、换行符格式：Java的\n是LF，Windows是\r\n）
• 签名串构造逻辑：strToSign的参数拼接顺序、是否包含URL编码、是否添加了时间戳/随机数等额外字段，必须和Java示例完全对齐
• 特殊字符处理：比如中文、特殊符号在不同编码下的字节差异

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