一、Java微信支付对接快速排查清单(可直接对照校验)
基础配置排查(必查,优先级最高)
- ✅ appid:确认与商户号绑定(公众号/小程序/App对应正确,无混淆)
- ✅ mchId:商户号正确,无多余空格、大小写错误
- ✅ 密钥核对:v2用API密钥(32位),v3用APIv3密钥+商户私钥,未混用、未复制不全
- ✅ 证书核对:apiclient_cert.p12/pem路径正确(无中文/空格)、格式为PKCS8(v3私钥)、密码为商户号
- ✅ 回调地址(notify_url):公网可访问、https协议(v3强制)、无参数、长度≤255位
接口调用排查
- ✅ 金额:单位为“分”(正整数),未传“元”或小数
- ✅ 订单号:out_trade_no≤32位,同一商户号下唯一,无重复
- ✅ trade_type匹配:JSAPI传openid、NATIVE传product_id、APP无需openid
- ✅ 签名:按对应版本算法(v2 MD5、v3 RSA-SHA256),参数按字典序排序,无空值/特殊字符未处理
- ✅ 网络:连接超时(5s)、读取超时(10s)已配置,无防火墙拦截、微信IP已放行
回调处理排查
- ✅ 回调可达:公网HTTPS,无内网/localhost,Postman可模拟回调成功
- ✅ 数据解析:v2用XML解析、v3用JSON解析,未混用解析方式
- ✅ 验签:回调数据已验签(与下单签名算法一致),未漏验
- ✅ 幂等性:已通过“商户订单号+状态”做唯一校验,避免重复处理
- ✅ 响应格式:成功返回{"code":"SUCCESS","message":"成功"