常见问题排查
密码服务平台连接失败、证书错误、性能问题排查指南
本页汇总接入与运行中的常见问题与排查思路。仍未解决请联系技术支持。
连接失败
- 现象：SDK 报连接超时 / 拒绝。
- 排查：确认 endpoint 地址与端口（默认 8443）可达；检查业务系统与平台是否同一安全域、防火墙放行；用
curl -k https://host:8443/v1/health验证服务存活。
认证错误（40101 / 40301）
- 40101 鉴权失败：核对 app_id / app_secret 或 token 是否正确、是否过期。
- 40301 无密钥权限：确认该应用是否被授权使用对应 key_id。
性能问题
- 吞吐不达预期：确认是否启用硬件密码资源（SM4 软件实现较慢）；大批量场景建议批量接口与连接复用。
- 延迟抖动：检查网络与密码机负载，必要时扩容集群副本。
算法/兼容问题
- 与国际系统互通时注意 SM2 兼容性；存量 RSA 数据迁移见 SM2 vs RSA。
- CBC/GCM 模式需正确传入 iv，否则解密失败或报参数错误（40020）。