微信小程序本地调试：网络请求与域名配置-CSDN博客

本文链接：https://blog.csdn.net/yu75567218/article/details/107788221

本文介绍了微信小程序在本地进行网络请求时的注意事项，包括服务器域名配置的必要性，以及如何在微信开发者工具中进行配置以实现与本地服务器的便捷调试。开发者需在小程序后台设置服务器域名，并注意基础库版本更新带来的功能变化，如从2.4.0开始允许局域网通信，2.7.0新增UDP通信。通过在开发工具中不校验域名，可简化本地调试过程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

官方文档中对于网络请求有详细介绍：https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html
在小程序/小游戏中使用网络相关的 API 时，需要注意下列问题，请开发者提前了解。
服务器域名配置
每个微信小程序需要事先设置通讯域名，小程序只可以跟指定的域名进行网络通信。包括普通 HTTPS 请求（wx.request）、上传文件（wx.uploadFile）、下载文件（wx.downloadFile) 和 WebSocket 通信（wx.connectSocket）。
从基础库 2.4.0 开始，网络接口允许与局域网 IP 通信，但要注意不允许与本机 IP 通信。
从 2.7.0 开始，提供了 UDP 通信（wx.createUDPSocket)。

配置流程
服务器域名请在「小程序后台-开发-开发设置-服务器域名」中进行配置，配置时需要注意：

域名只支持 https (wx.request、wx.uploadFile、wx.downloadFile) 和 wss (wx.connectSocket) 协议；
域名不能使用 IP 地址（小程序的局域网 IP 除外）或 localhost；
可以配置端口，如 https://myserver.com:8080，但是配置后只能向 https://myserver.com:8080 发起请求。如果向 https://myserver.com、https://myserver.com:9091 等 URL 请求则会失败。
如果不配置端口。如 https://myserver.com，那么请求的 URL 中也不能包含端口，甚至是默认的 443 端口也不可以。如果向 https://myserver.com:443 请求则会失败。
域名必须经过 I