微信小程序开发时本地接口无法外网访问怎么办？用贝锐花生壳打通真机调试链路
做过微信小程序开发的人大多踩过同一个坑：开发者工具里一切正常，点“预览”用手机一扫，接口请求全部失败。问题往往不在代码，而在于网络可达性——小程序跑在手机上，而你的服务跑在开发机上。localhost 指的是开发机自己，手机端的 localhost 当然访问不到。把这段链路打通，是调试阶段绕不开的一步。
1. 先弄清微信小程序对网络访问的硬性规则
在正式环境，每个小程序都需要事先设置通讯域名，只能与指定域名通信。规则有几条要点：域名必须经过 ICP 备案；域名只支持 HTTPS 和 WSS 协议；域名不能使用 IP 地址或 localhost；每个接口分别可配置最多 20 个域名。开发环境的要求相对宽松，但真机测试时依然需要外网能够访问到开发计算机，这个前提没有变化。
换句话说，你需要的是一个“外部可解析、支持 HTTPS、不是 IP 地址”的访问入口。这正是内网穿透要解决的问题。
2. 内网穿透补的是哪一段能力
贝锐花生壳提供两项关键能力：域名和端口映射。落到小程序场景里，就是把本地开发机上运行的服务，映射成一个外网可以访问的 HTTPS 地址。由于证书部署在花生壳服务侧，本地服务器无需自行购买和部署证书，省掉了申请、验证、续期这一整套动作。
对调试来说，这一点很关键：你不需要动路由器、不需要公网 IP，也不需要为调试临时配一套证书链。
3. 映射配置：类型与内网参数的对应关系
在映射类型的选择上，贝锐花生壳只提供 TCP 与 HTTPS 两类。网站、Web 管理界面这类需要浏览器直接访问的服务选 HTTPS；远程桌面、SSH、数据库、FTP、软件类、监控摄像头等选 TCP。小程序的接口服务本质上是一个 Web 服务，因此映射类型选 HTTPS。
外网域名可以选择账号下自带证书的加密壳域名，常见后缀为 hsk.top、zicp.fun、yicp.fun；内网主机填写小程序服务部署所在机器的局域网 IP，内网端口填写服务实际监听的端口号。保存后系统会自动生成一条 HTTPS 类型的外网访问地址，此时就可以进入小程序侧的配置了。
4. 小程序后台的合法域名要同步更新
拿到外网地址后，登录微信公众平台，进入【设置】→【开发设置】→【服务器域名】，在 request 合法域名处填写已经映射好的 HTTPS 地址。接着打开微信开发者工具，在需要调试的项目中添加这个 HTTPS 地址作为请求 URL，就可以继续调试了。
这里有个容易被忽略的细节：微信小程序开发阶段虽然在开发者工具里可以勾选“不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书”来临时放宽限制，但这只是绕开校验，并不能替代真实的外网可达地址。一旦涉及真机、涉及需要 HTTPS 的接口，映射出来的地址仍然是必需品。
5. 真机预览：用手机验证整条链路
点击开发者工具中的“预览”，用手机扫描二维码，在手机端查看实际访问效果，这一步是验证映射是否真正生效的最直接方式。如果打不开，排查顺序建议固定下来：先确认开发机上服务本身可访问，再确认映射已生成外网地址，最后核对小程序后台的合法域名是否与映射地址完全一致。
6. 正式发布前需要补的两件事
第一，域名性质。壳域名提供国内备案服务，可用于正式对外站点，商用正式站点需要绑定已完成 ICP 备案的自有顶级域名。第二，稳定性预期。HTTPS 映射会自动部署证书、无需在本地做额外配置，这降低了运维负担，但正式环境仍建议按实际访问量规划带宽与线路。
