微信支付簽名失敗：APP_KEY 找不到的排查方向

錯誤現象

調用微信支付 API 時提示「簽名失敗，APP_KEY 找不到」，通常伴隨截圖顯示錯誤碼或回調失敗。

常見原因與解決

1. 商戶平台未配置 API 密鑰：登入 微信商戶平台 → 賬戶中心 → API 安全 → 設置 API 金鑰（Key）。此 Key 為 32 位字串，用於簽名算法。
2. SDK 版本不匹配：確認使用的 SDK（Java/PHP/Python/Go 等）版本與微信支付文檔一致，舊版 SDK 可能缺少字段或簽名邏輯變更。
3. 參數名稱錯誤：簽名需包含所有非空參數，參數名需與文檔完全一致（區分大小寫），如 appid、mch_id、nonce_str、sign 等。
4. 編碼問題：確保請求體為 UTF-8，簽名字串拼接時按 ASCII 碼排序，最後拼接 key=商戶Key 做 MD5/HMAC-SHA256。
5. 測試環境與正式環境混淆：沙箱環境與正式環境的 AppID、MchID、Key 完全不同，不可混用。

排查步驟

1. 在商戶平台「開發配置」確認已設置 API Key 並啟用。
2. 使用官方提供的「簽名驗證工具」對比本地生成的簽名。
3. 抓包（Wireshark/Fiddler）查看實際發送的 XML/JSON，核對參數完整性。
4. 檢查 SDK 代碼中獲取 Key 的邏輯，是否從配置文件正確讀取。

關鍵代碼片段（Java 示例）

// 正確讀取 Key
String apiKey = config.getProperty("wechat.pay.apiKey"); // 從配置文件讀取
// 簽名生成
Map<String, String> params = new TreeMap<>(); // 自動按鍵排序
params.put("appid", appId);
params.put("mch_id", mchId);
// ... 其他參數
String sign = WXPayUtil.generateSignature(params, apiKey); // SDK 內部實現
params.put("sign", sign);

總結

「APP_KEY 找不到」本質是簽名驗證失敗，核心在於商戶 Key 配置缺失或參數構造錯誤。按上述清單逐項排查即可定位。