wxjava-troubleshooter git:20260720.871b042A

Immutable. This exact content is served forever at /api/v1/blob/75e35b6eb79d442d.

---
name: wxjava-troubleshooter
description: 排查 WxJava 在配置初始化、access token、签名验签、支付证书、回调通知、序列化、网络请求和多账号隔离方面的问题。适用于用户提供异常、日志、请求响应或“WxJava 为什么不能调用”的场景。
---

# WxJava 故障排查

1. 收集最小复现：产品模块、SDK 版本、JDK、框架、依赖树、异常堆栈、请求 ID 与脱敏后的配置形状。
2. 将故障归类为依赖/初始化、token 与存储、请求契约、HTTP/代理、回调验签、支付证书或并发与生命周期。
3. 依据 [诊断清单](references/diagnostics.md)，按最低成本、最可验证的顺序排查。
4. 每次只提出一个可验证根因，给出最小修复、预期现象和回归验证动作。
5. 签名、支付、回调和加密场景须核对编码、字段排序、金额精度、时间戳、证书链和重放保护。

要求遮蔽 secret、token、私钥、证书、签名原文和个人数据。不要建议关闭 TLS 校验或验签；区分已证实结论与待验证假设。遇到历史同类问题时，给出对应 Issue 或 Wiki 链接，但必须检查当前版本的实现后再套用修复。