联调第三方支付回调,验签一直 401。对方说签名不对,我们日志里算出来的 sign 和回调带的差两个字符。
先把两边的待签串打出来对比。差异集中在金额字段,我们拿到的是 amount=100 00,中间多了个空格,原文是 100+00。
第一反应是框架把参数重新编码了。Spring 的 @RequestParam 按 form 规则解析,加号在 application/x-www-form-urlencoded 里代表空格,解码后自然变成空格。
试过在参数上手动把空格换回加号,能对上这一单,下一单金额里带 %2B 又错了。这种补丁式修法迟早出事。
换成读原始报文。签名必须基于 body 的字节,不能基于任何反序列化后的对象。用 @RequestBody 拿 byte 数组,再做一次 UTF-8 解码,中间不经任何转换。
@PostMapping("/notify")
public String notify(@RequestBody byte[] raw) {
String body = new String(raw, StandardCharsets.UTF_8);
log.info("len={}", raw.length);
return verify(body) ? "success" : "fail";
}
还有一个坑在网关。Nginx 的 lua 模块如果读了 body 再转发,Content-Length 可能被改写,上游拿到的内容和签名源不一致。验签放在最外层,网关只做透传。
日志里别直接打完整报文。金额、手机号要脱敏,只留前 6 位和后 4 位,原始字节存到单独的审计表,保留 7 天。
确认方式:抓 200 笔回调重放,sign 全部一致;故意把 body 里的加号改空格,验签必须失败,说明校验真的在跑,不是恒真。
最后和对方确认了编码。他们用 GBK 拼串,我们用 UTF-8,英文数字没问题,一出现中文商户名就错。两边统一 UTF-8 并写进接口文档,这类问题才算收口。
