- 配置：模块是否正确，应用标识和凭据是否配对，多账号配置是否被正确选择。
- 请求：HTTP 方法、路径、必填字段和 JSON/XML 映射是否符合微信接口契约。
- 认证：token 缓存、签名字段、时间戳、nonce、证书和密钥格式是否有效。
- 网络：DNS、代理、超时、TLS 证书校验和响应关闭是否正常。
- 回调：回调 URL 可访问、验签参数完整、幂等处理和资源释放是否存在。
从精确异常和最小请求入手，不用“重试”替代根因分析。
| 症状 | 优先检查 | 依据 |
|---|---|---|
| 多节点间歇性 token 失效 | 是否共享 token/config storage，是否让各节点并发刷新 | Wiki 的 MP/CP 配置存储说明与集群案例 |
NoClassDefFoundError、NoSuchMethodError |
mvn dependency:tree、HttpClient/commons-lang/xstream 冲突及 BOM 是否统一版本 |
Wiki 的异常排查页与 HTTP 客户端升级指南 |
| 回调验签或重复处理 | 原始请求体、时间戳/nonce/签名、回调 URL、业务幂等键 | MP 合法性校验与支付回调说明 |
| HTTP 连接、超时或代理问题 | 连接/读取超时、代理、TLS、正反向代理是否混用 | Wiki 的 HttpClient 参数与代理文档 |
| 企业微信会话存档崩溃 | 是否仍手动销毁旧 SDK 实例，是否已迁移安全 API | 会话存档安全使用指南 |
| 视频号/小店接口 404 或字段不匹配 | 当前官方路径与请求字段、目标 SDK 版本、历史 Issue 是否已修复 | 关闭的 bug Issue，如 #3982 |