微信开发调试总卡在公网访问？贝锐花生壳内网穿透的落地做法
1. 微信开发调试绕不开的两道门槛
做过小程序或公众号对接的人都会遇到同一个场景：页面在本地跑得好好的，一进入真机联调就卡住。原因并不复杂。正式环境对域名有硬性约束：域名必须经过 ICP 备案、只支持 HTTPS 与 WSS 协议、不能使用 IP 地址或 localhost，并且每个接口分别有可配置域名的数量上限。而在开发阶段，手机上的小程序要访问的其实是开发者电脑上的服务，这本身就是一次跨设备的外网访问。
2. 先把本地服务跑通，再考虑映射
外网访问的前提是内网服务本身健康。比较稳妥的顺序是：本地先把 Web 服务或接口服务启动起来，用浏览器访问本地地址确认页面与接口能正常返回；如果服务启动报错，优先检查端口是否被其他程序占用，必要时修改配置文件中的端口再重启。这一步看似基础，却能过滤掉大量“映射做了但不通”的情况。很多微信开发调试中的疑难，根源并不在映射配置，而在于本地服务并未真正监听或在监听另一个端口。
3. 映射类型怎么选：HTTPS 与 TCP 的边界
选型时按被访问的对象判断即可。如果对外暴露的是网站、后台管理界面、接口服务这类 Web 形态的内容，选择 HTTPS 映射，由服务端完成证书部署，本地无需自行签发和配置证书。如果是远程桌面、SSH、数据库这类非 Web 服务，则选择 TCP 映射。花生壳当前对外提供的协议能力即为 TCP 与 HTTPS 两类，客户端覆盖多种操作系统，包括 Windows、macOS、Linux 等。
4. 小程序侧：服务器域名与开发者工具要一起改
小程序侧的配置有两个动作。第一，登录微信公众平台，在【设置】→【开发设置】→【服务器域名】处，把已映射好的 HTTPS 地址填入 request 合法域名。第二，打开微信开发者工具，在需要调试的项目中把请求 URL 换成同一个 HTTPS 地址，随后即可正常发起调试。开发阶段如果还没准备好备案域名，可以在开发者工具中选择“不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书”先把链路打通。这一阶段的微信开发调试重点在于验证请求与响应结构，不必过早纠结域名资质。
5. 公众号侧：接口 URL 与 Token 校验
公众号接入比小程序更“原始”一些，本质是平台向配置的 URL 发起一次校验请求。做法是把映射得到的外网域名填入接口 URL（注意带应用路径），再自行设定一个 Token 字符串后提交。如果暂时没有认证服务号，可以先用接口测试号完成验证，测试号基本可以调用平台的高级接口能力。校验逻辑是把 timestamp、nonce 与自定义 Token 按字母顺序排序拼接后做 SHA1 运算，结果与平台传来的 signature 一致则返回 echostr，校验通过即代表通道建立完成。这一环节的微信开发调试建议在日志里完整打印四个入参与计算后的签名，出问题时可快速定位是参数缺失还是签名不匹配。
6. 上线之前：域名资质与排查顺序
开发与上线是两套标准。花生壳赠送的壳域名提供国内备案服务，可用于正式对外站点，正式发布的小程序需绑定已完成 ICP 备案的自有顶级域名。映射完成后会生成外网访问地址，如访问不通，按“客户端在线状态 → 内网主机 IP → 内网端口 → 协议类型”的顺序逐项核对，通常能快速收敛问题。把这条排查链路固化下来，后续每次微信开发调试都能少走一轮弯路。
