166 lines
4.8 KiB
Markdown
166 lines
4.8 KiB
Markdown
# 微信支付证书问题修复指南
|
||
|
||
## 问题描述
|
||
|
||
错误信息：`创建支付订单失败：创建支付订单失败：Cannot invoke "java.security.cert.X509Certificate.getSerialNumber()" because "certificate" is null`
|
||
|
||
## 问题原因
|
||
|
||
这个错误通常发生在使用微信支付SDK的 `RSAAutoCertificateConfig` 时，SDK尝试自动下载微信支付平台证书但失败，导致证书对象为null。
|
||
|
||
常见原因包括：
|
||
1. 商户平台未开启API安全功能
|
||
2. 未申请使用微信支付公钥
|
||
3. 网络连接问题
|
||
4. 商户证书序列号错误
|
||
5. APIv3密钥配置错误
|
||
|
||
## 解决方案
|
||
|
||
### 1. 商户平台配置
|
||
|
||
#### 步骤1：开启API安全功能
|
||
1. 登录 [微信商户平台](https://pay.weixin.qq.com)
|
||
2. 进入【账户中心】->【API安全】
|
||
3. 点击【申请使用微信支付公钥】
|
||
4. 按照指引完成申请流程
|
||
|
||
#### 步骤2：下载证书文件
|
||
1. 在API安全页面下载商户证书
|
||
2. 获取以下文件：
|
||
- `apiclient_cert.pem` (商户证书)
|
||
- `apiclient_key.pem` (商户私钥)
|
||
3. 记录商户证书序列号
|
||
|
||
#### 步骤3：设置APIv3密钥
|
||
1. 在API安全页面设置APIv3密钥
|
||
2. 密钥必须是32位字符串（字母和数字组合）
|
||
3. 妥善保管密钥，不要泄露
|
||
|
||
### 2. 开发环境配置
|
||
|
||
#### 证书文件放置
|
||
将证书文件放置到以下目录：
|
||
```
|
||
src/main/resources/dev/wechat/{tenantId}/
|
||
├── apiclient_key.pem # 必需：商户私钥
|
||
└── apiclient_cert.pem # 可选：商户证书（自动配置不需要）
|
||
```
|
||
|
||
例如，租户ID为10550的证书路径：
|
||
```
|
||
src/main/resources/dev/wechat/10550/
|
||
├── apiclient_key.pem
|
||
└── apiclient_cert.pem
|
||
```
|
||
|
||
#### 数据库配置
|
||
在 `payment` 表中配置以下信息：
|
||
- `mch_id`: 商户号
|
||
- `app_id`: 应用ID
|
||
- `merchant_serial_number`: 商户证书序列号
|
||
- `api_key`: APIv3密钥（32位）
|
||
|
||
### 3. 生产环境配置
|
||
|
||
#### 证书文件上传
|
||
将证书文件上传到服务器指定目录，通常是：
|
||
```
|
||
/www/wwwroot/file.ws/file/{相对路径}/
|
||
```
|
||
|
||
#### 数据库配置
|
||
在 `payment` 表中配置证书文件的相对路径：
|
||
- `apiclient_key`: 私钥文件相对路径
|
||
- `apiclient_cert`: 商户证书文件相对路径
|
||
|
||
### 4. 代码修复
|
||
|
||
系统已经实现了自动回退机制：
|
||
|
||
1. **优先使用自动证书配置**：`RSAAutoCertificateConfig`
|
||
2. **自动回退到手动配置**：如果自动配置失败，会回退到 `RSAConfig` 或 `RSAPublicKeyConfig`
|
||
3. **详细错误诊断**：提供具体的错误信息和修复建议
|
||
|
||
### 5. 诊断工具
|
||
|
||
#### 使用证书诊断API
|
||
```bash
|
||
# 诊断特定租户的证书配置
|
||
GET /system/wechat-pay-diagnostic/diagnose/{tenantId}
|
||
|
||
# 获取解决方案
|
||
GET /system/wechat-pay-diagnostic/solutions
|
||
|
||
# 测试证书配置
|
||
POST /system/wechat-pay-diagnostic/test/{tenantId}
|
||
```
|
||
|
||
#### 查看诊断日志
|
||
在应用日志中查看详细的诊断信息：
|
||
```
|
||
=== 微信支付证书诊断报告 ===
|
||
租户ID: 10550
|
||
商户号: 1723321338
|
||
应用ID: wx1234567890abcdef
|
||
商户证书序列号: 2B933F7C35014A1C363642623E4A62364B34C4EB
|
||
APIv3密钥: 已配置(32位)
|
||
证书文件路径: dev/wechat/10550/apiclient_key.pem
|
||
证书文件存在: 是
|
||
配置验证结果: 通过
|
||
```
|
||
|
||
## 常见问题排查
|
||
|
||
### Q1: 404错误
|
||
**原因**：商户平台未开启API安全功能
|
||
**解决**：按照上述步骤1开启API安全功能
|
||
|
||
### Q2: 证书序列号不匹配
|
||
**原因**：数据库中配置的序列号与实际证书不符
|
||
**解决**：
|
||
1. 在商户平台查看正确的序列号
|
||
2. 更新数据库中的 `merchant_serial_number` 字段
|
||
|
||
### Q3: APIv3密钥错误
|
||
**原因**：密钥长度不是32位或包含非法字符
|
||
**解决**：
|
||
1. 重新设置32位APIv3密钥
|
||
2. 确保只包含字母和数字
|
||
|
||
### Q4: 私钥文件不存在
|
||
**原因**：证书文件路径错误或文件未上传
|
||
**解决**：
|
||
1. 检查文件路径是否正确
|
||
2. 确保文件已正确放置
|
||
|
||
### Q5: 网络连接问题
|
||
**原因**：服务器无法访问微信支付API
|
||
**解决**：
|
||
1. 检查网络连接
|
||
2. 确保防火墙允许HTTPS出站连接
|
||
3. 检查代理设置
|
||
|
||
## 最佳实践
|
||
|
||
1. **使用自动证书配置**：推荐使用 `RSAAutoCertificateConfig`，可自动管理平台证书
|
||
2. **定期检查证书有效期**：避免证书过期导致的问题
|
||
3. **妥善保管私钥**：确保私钥文件安全，不要泄露
|
||
4. **使用HTTPS**：所有支付相关通信都应使用HTTPS
|
||
5. **监控日志**：定期查看支付相关日志，及时发现问题
|
||
|
||
## 技术支持
|
||
|
||
如果按照以上步骤仍无法解决问题，请：
|
||
|
||
1. 查看完整的错误日志
|
||
2. 使用诊断API获取详细信息
|
||
3. 检查微信商户平台的配置状态
|
||
4. 联系技术支持团队
|
||
|
||
## 相关文档
|
||
|
||
- [微信支付官方文档](https://pay.weixin.qq.com/doc/v3/merchant/4012153196)
|
||
- [API安全配置指南](https://pay.weixin.qq.com/doc/v3/merchant/4012153196)
|
||
- [证书和回调报文验证](https://pay.weixin.qq.com/doc/v3/wechatpay/wechatpay4_1.shtml)
|