签名接口报 401 加号变空格 原始 body 怎么留

联调第三方支付回调,验签一直 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 并写进接口文档,这类问题才算收口。

您可以还会对下面的文章感兴趣: