微信支付V3 错误的签名？

Question

微信支付V3 报错应该怎么解决

 /** 商户号 */
    public static String merchantId = "1101245633";

    /** 商户API私钥路径 */
    public static String privateKeyPath = "apiclient_key.pem";

    /** 商户证书序列号 */
    public static String merchantSerialNumber = "4AB2683D6D167EA4D1886131C437BFB485BFCC0E";

    /** 商户APIV3密钥 */
    public static String apiV3Key = "ZPXXwxzf1101245633Gongxiangsheng";
    /** 初始化微信支付服务 */
    public  JsapiService initWxPayService() {
        String privateKeyPath1 = getClasspathFileAbsolutePath(privateKeyPath);
        Config config =
                new RSAAutoCertificateConfig.Builder()
                        .merchantId(merchantId)
                        // 使用 com.wechat.pay.java.core.util 中的函数从本地文件中加载商户私钥，商户私钥会用来生成请求的签名
                        .privateKeyFromPath(privateKeyPath1)
                        .merchantSerialNumber(merchantSerialNumber)
                        .apiV3Key(apiV3Key)
                        .build();
        // 初始化服务
        service = new JsapiService.Builder().config(config).build();
        return service;
    }
报错
[{"code":"SIGN_ERROR","detail":{"detail":{"issue":"sign not match"},"field":"signature","location":"authorization","sign_information":{"method":"GET","sign_message_length":85,"truncated_sign_message":"GET\n/v3/certificates?algorithm_type=RSA\n1765362220\nqeFssCwHvCPJf9gdma7eD8NRjvvnYOVR\n\n","url":"/v3/certificates?algorithm_type=RSA"}},"message":"错误的签名，验签失败"}]    HttpRequest[{"http_method":"GET","url":"https://api.mch.weixin.qq.com/v3/certificates?algorithm_type=RSA","uri":"https://api.mch.weixin.qq.com/v3/certificates?algorithm_type=RSA","headers":{"headers":{"Authorization":"WECHATPAY2-SHA256-RSA2048 mchid=\"1101245633\",nonce_str=\"qeFssCwHvCPJf9gdma7eD8NRjvvnYOVR\",timestamp=\"1765362220\",serial_no=\"4AB2683D6D167EA4D1886131C437BFB485BFCC0E\",signature=\"H5dn8BK00qbe7jOX2Gl40YN4at8EdROuCGJ3uh9UzPE/G200Rg5lVlUuZcidTxQVSS9qj/fcIdcG0npIFzl2ISFWr7TiwK7TZnbkbM1oStMRRnfGymaMntQyZIV1r5ks1Tb2sclnn4rJQ47m4MZ2V0Yovx3cllwzR7gsFMG46vIe86uhdPaObnpHPbhqm2cvcCG+iLdGzNKprjQ/75mapHT0ntg9Vr5GIpCgFdufhxMoesZRBnweNLE7tAPWjF357FST00QvWcOuZociZgLFlsmGEcmj4AVcRW0XO6Ea+CYkx8zfj812fE5bKaXTTe9eqlva82k2nJP532JyynISRQ==\"","Accept":" */*","User-Agent":"WechatPay-Java/0.2.17 (Windows 11/10.0) Java/17.0.16 Credential/WechatPay2Credential Validator/ okhttp3/null","Content-Type":"application/json","Wechatpay-Serial":""}}}]

搞一天没解决，大家帮帮忙

Answer 1

晚上好🌙🌙🌙
本答案参考通义千问

你遇到的 “SIGN_ERROR” 错误是 微信支付 V3 接口签名验证失败，这是最常见且最容易出错的问题之一。从你的报错信息来看，签名不匹配，说明 签名生成过程有误，可能是私钥、API 密钥、时间戳、随机字符串或请求体格式等问题。

---

✅ 一、问题分析

根据错误信息：

"sign_information":{"method":"GET","sign_message_length":85,"truncated_sign_message":"GET\n/v3/certificates?algorithm_type=RSA\n1765362220\nqeFssCwHvCPJf9gdma7eD8NRjvvnYOVR\n\n","url":"/v3/certificates?algorithm_type=RSA"}}

我们可以看到：

• 请求方法：GET
• URL：/v3/certificates?algorithm_type=RSA
• 时间戳：1765362220
• 随机字符串：qeFssCwHvCPJf9gdma7eD8NRjvvnYOVR
• 没有请求体（因为是 GET 请求）

签名计算方式为：

signature = HMAC-SHA256(签名密钥, 签名串)

其中签名串的格式为：

HTTP_METHOD + "\n" +
URL + "\n" +
TIMESTAMP + "\n" +
NONCE_STR + "\n" +
BODY + "\n"

由于你是 GET 请求，没有 BODY，所以签名串是：

GET\n/v3/certificates?algorithm_type=RSA\n1765362220\nqeFssCwHvCPJf9gdma7eD8NRjvvnYOVR\n

但你的签名结果与系统期望不符，说明签名生成逻辑可能有问题。

---

✅ 二、解决方案步骤

1. 检查商户私钥是否正确

• 确保 apiclient_key.pem 文件路径正确。
• 确认文件内容是 正确的 RSA 私钥（PEM 格式），例如：

  -----BEGIN PRIVATE KEY-----
  MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEBMAsGA1UdEQQCMAA=
  ...
  -----END PRIVATE KEY-----
  

❗ 如果你使用的是 PKCS#8 格式的私钥，请确认是否被正确加载。

---

2. 确保 API V3 密钥正确

• apiV3Key 是用于 HMAC-SHA256 加密 的密钥，不是私钥。
• 它应该是一个 32 字节的字符串，比如：

  ZPXXwxzf1101245633Gongxiangsheng
  

• 请确保它和你在 微信商户平台 中设置的一致。

---

3. 检查时间戳是否正确

• 微信要求时间戳是 当前时间的秒级 Unix 时间戳。
• 你当前的时间戳是 1765362220，对应的是 2026年2月1日，明显是未来时间。
• 这会导致签名无效，因为微信会拒绝非当前时间的请求。

✅ 解决方法：在代码中动态获取当前时间戳，而不是硬编码。

---

4. 检查随机字符串是否唯一且符合规范

• 随机字符串应为 32 位以上 的随机字符串。
• 不要重复使用相同的 nonce_str。
• 你可以使用如下方式生成：

  String nonceStr = UUID.randomUUID().toString().replace("-", "");
  

---

5. 确认证书序列号是否正确

• merchantSerialNumber 应该是 商户证书的序列号。
• 请登录 微信商户平台 查看你的证书信息。
• 通常可以在 账户设置 > API安全 > API证书 中找到。

---

✅ 三、修改后的代码示例

以下是修复后的代码，重点部分已加粗：

public JsapiService initWxPayService() {
    // 获取私钥路径
    String privateKeyPath1 = getClasspathFileAbsolutePath(privateKeyPath);

    // 使用 RSAAutoCertificateConfig 来自动处理证书
    Config config = new RSAAutoCertificateConfig.Builder()
        .merchantId(merchantId)
        .privateKeyFromPath(privateKeyPath1)  // 正确加载私钥
        .merchantSerialNumber(merchantSerialNumber)  // 正确的证书序列号
        .apiV3Key(apiV3Key)  // 正确的 API V3 密钥
        .build();

    // 初始化服务
    service = new JsapiService.Builder().config(config).build();
    return service;
}

⚠️ 注意：如果你使用的是 GET 请求，请确保不要添加额外的请求体（如 JSON）。

---

✅ 四、调试建议

1. 打印签名串：在调用接口前，打印出实际生成的签名串，对比微信官方文档中的格式。
2. 使用工具验证签名：可以使用 微信支付签名工具 手动验证签名是否正确。
3. 检查服务器时间：确保服务器时间与网络时间同步，避免因时区或时间偏差导致签名失效。

---

✅ 五、总结

| 问题类型 | 原因 | 解决方案 | |--------|------|----------| | 签名错误 | 私钥、API密钥、时间戳、随机字符串等不一致 | 检查并替换为正确的值 | | 时间戳错误 | 使用了过期或未来时间 | 动态生成当前时间戳 | | 随机字符串重复 | 多次请求使用相同随机字符串 | 每次请求生成唯一随机字符串 | | 证书序列号错误 | 使用了错误的证书编号 | 从微信商户平台获取正确值 |

---

✅ 六、附加：手动验证签名的示例（Java）

import java.security.Signature;
import java.security.PrivateKey;
import java.security.cert.X509Certificate;
import java.util.Base64;

public class SignUtil {

    public static String sign(String method, String url, String timestamp, String nonceStr, String body, PrivateKey privateKey, String apiV3Key) throws Exception {
        String signString = String.format("%s\n%s\n%s\n%s\n%s\n", 
            method, url, timestamp, nonceStr, body);
        
        Signature signature = Signature.getInstance("SHA256withRSA");
        signature.initSign(privateKey);
        signature.update(signString.getBytes());
        byte[] signed = signature.sign();
        
        return Base64.getEncoder().encodeToString(signed);
    }
}

---

如果你仍然无法解决问题，请提供完整的调用代码和你使用的 SDK 版本，我可以进一步帮你定位问题。希望这些信息能帮助你顺利解决签名问题！