调用NETSUITE API持续返回Invalid signature错误如何排查？

已定位的错误点 #

• 签名密钥构造缺失Token Secret
  OAuth 1.0 HMAC-SHA256签名的密钥规则为Consumer_Secret&Token_Secret，你当前代码注释掉了正确的密钥构造逻辑，仅拼接了Consumer Secret和&符号，缺少Token Secret，这是签名错误的核心原因。
• Account ID格式不匹配
  NetSuite规则要求：请求URL中的Account ID需要将原ID的下划线替换为连字符、转全小写；而请求头的realm参数必须使用带下划线的原始Account ID，需要你核对当前传入的baseUrl是否符合规则。
• Base64编码存在多余换行
  你使用的Base64Coder.encodeLines方法默认会在编码结果中插入换行符，即使做了trim处理也可能存在不可见字符，建议使用无换行的Base64编码方案。
• 参数编码逻辑不符合OAuth规范
  构造参数列表时，需要将每个参数的key和value分别做URL编码后，再拼接为key=value格式，最后用&连接所有参数。你当前是直接拼接未编码的key和value后再整体编码，若参数值存在特殊字符会导致签名串错误。
• 时间戳误差问题
  偶发的invalid timestamp报错是因为本地设备时间与NetSuite服务器时间差超过5分钟，同步本地系统时间即可解决。
• 请求方法大小写问题
  构造签名基础串的请求方法必须为全大写（如GET、POST），不能使用小写或混合大小写格式。

修正后的核心代码片段 #

// 修正1：构造正确的签名密钥
String consumerSecretEncoded = URLEncoder.encode(userFields.getConsumerSecret(), StandardCharsets.UTF_8);
String tokenSecretEncoded = URLEncoder.encode(userFields.getTokenSecret(), StandardCharsets.UTF_8);
String signKey = consumerSecretEncoded + "&" + tokenSecretEncoded;
SecretKeySpec signingKey = new SecretKeySpec(signKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256");

// 修正2：参数逐个编码后再拼接
ArrayList<String> parameters = new ArrayList<>();
parameters.add(URLEncoder.encode(ApplicationConstants.CONSUMER_KEY, StandardCharsets.UTF_8) + "=" + URLEncoder.encode(userFields.getConsumerKey(), StandardCharsets.UTF_8));
parameters.add(URLEncoder.encode(ApplicationConstants.NONCE, StandardCharsets.UTF_8) + "=" + URLEncoder.encode(nonce, StandardCharsets.UTF_8));
parameters.add(URLEncoder.encode(ApplicationConstants.SIGNATURE_METHOD_KEY, StandardCharsets.UTF_8) + "=" + URLEncoder.encode(ApplicationConstants.SIGNATURE_METHOD_VAL, StandardCharsets.UTF_8));
parameters.add(URLEncoder.encode(ApplicationConstants.TIMESTAMP, StandardCharsets.UTF_8) + "=" + URLEncoder.encode(String.valueOf(timestamp), StandardCharsets.UTF_8));
parameters.add(URLEncoder.encode(ApplicationConstants.OAUTH_TOKEN, StandardCharsets.UTF_8) + "=" + URLEncoder.encode(userFields.getTokenId(), StandardCharsets.UTF_8));
parameters.add(URLEncoder.encode(ApplicationConstants.VERSION_KEY, StandardCharsets.UTF_8) + "=" + URLEncoder.encode(ApplicationConstants.VERSION_VAL, StandardCharsets.UTF_8));
Collections.sort(parameters);

// 修正3：使用无换行的Base64编码
Mac m = Mac.getInstance("HmacSHA256");
m.init(signingKey);
byte[] res = m.doFinal(signatureString.getBytes(StandardCharsets.UTF_8));
signature = Base64.getEncoder().encodeToString(res);

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