1. 測試賬號獲取
- 訂閱號（個人可申請）、服務號/企業號（需企業資質）。
- 未認證訂閱號接口權限受限（無自定義菜單、支付、網頁授權等）。
- 推薦：使用微信官方測試公眾號平台：
https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
掃碼授權即得擁有完整高級接口權限的測試號。
2. 本地調試痛點
開發過程頻繁部署到公網雲主機，依賴日誌排查，效率極低。核心需求：讓微信伺服器能直接訪問本機開發端口。
3. 內網穿透工具：ngrok
- Go 語言編寫，跨平台（Windows/Linux/macOS）。
- 官網需翻牆，國內有鏡像站下載。
- 註冊獲取 Authtoken。
Windows 快速啟動
# 解壓後首次綁定 token
ngrok.exe -authtoken YOUR_AUTHTOKEN 80
# 日常啟動：將本地 8080 映射到公網 HTTP
ngrok.exe http 8080
啟動成功界面關鍵信息
Forwarding https://abc123.ngrok.io -> https://localhost:8080
Forwarding https://abc123.ngrok.io -> https://localhost:8080
複製 HTTPS 域名（如 https://abc123.ngrok.io）作為微信後台「服務器配置」的 URL。
4. 微信測試號配置步驟
- 登錄測試號管理頁，點擊「修改配置」。
- URL 填寫 ngrok HTTPS 域名 + 接口路徑（如
/wechat）。
- Token 隨意填寫（需與代碼一致），EncodingAESKey 點擊隨機生成。
- 提交驗證，綠色「驗證成功」即完成。
5. 開發工作流優化
- 代碼修改 → 熱重載（Spring Boot DevTools / IDEA HotSwap） → 直接在本地斷點調試。
- ngrok 免費版域名每次重啟變動，只需在測試號後台更新 URL 即可。
- 若 ngrok 官方服務不穩，可自建 ngrokd 服務端（需公網 IP）。
6. 常見問題
- 驗證失敗：檢查 Token 一致性、防火牆放行 8080、ngrok 隧道存活。
- 收不到消息：確認 Controller 映射路徑與 URL 路徑一致、POST 請求體解析正確。
- HTTPS 證書：ngrok 提供有效 HTTPS，微信強制要求 HTTPS，無需自簽。
總結
「測試公眾號 + ngrok 內網穿透」構建零成本、高效率的微信開發調試環境，讓開發者專注業務邏輯而非部署運維。
