Files
life-echo/api/certs/README_wechat_cert.md
iammm0 d2c7505649 docs: 新增证书说明与数据库迁移文档
- 新增 api/certs/README_wechat_cert.md
- 新增 api/migrations/README.md
- 新增 api/migrations/sync_schema_to_models.sql

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 14:42:32 +08:00

1.1 KiB

微信支付 401 签名错误排查

原因

WECHAT_PAY_CERT_SERIAL_NO 必须是「商户 API 证书」的序列号,且该证书与 apiclient_key.pem(商户私钥)为一对。
若序列号与私钥不对应,微信会返回 401 签名错误。

获取正确序列号

方式一:从商户证书文件读取(推荐)

若你有 apiclient_cert.pem(与 apiclient_key.pem 同时从商户平台下载):

cd api
openssl x509 -in certs/apiclient_cert.pem -noout -serial

输出示例:serial=55D97D542DBAA9CB9B7D0ACDB810CC99C208D328
将等号后面的十六进制(可全部大写)填到 .envWECHAT_PAY_CERT_SERIAL_NO

方式二:从商户平台查看

登录 微信支付商户平台账户中心API 安全API 证书 → 查看与当前私钥对应的证书序列号,复制到 WECHAT_PAY_CERT_SERIAL_NO

其他可能

  • 私钥与证书不是一对:重新在商户平台下载 API 证书,使用新的 apiclient_key.pem 与证书序列号。
  • 服务器时间偏差:与标准时间误差不要超过约 5 分钟。