在微信小程序中配置服务器域名和接口地址,需要完成后台配置和代码开发两部分工作。以下是详细步骤:
一、登录微信公众平台
- 访问 微信公众平台
- 使用小程序管理员账号扫码登录
二、配置服务器域名(关键步骤)
⚠️ 注意:从微信开发者工具 v2.0+ 开始,所有网络请求的域名必须在「开发设置」中提前配置,否则无法调用
wx.request等接口。
操作步骤:
- 进入左侧菜单:开发 → 开发管理 → 开发设置
- 找到 「服务器域名」 区域
- 点击对应分类下的 添加按钮:
- request 合法域名(用于
wx.request) - socket 合法域名(用于 WebSocket)
- uploadFile 合法域名(用于文件上传)
- downloadFile 合法域名(用于文件下载)
- request 合法域名(用于
- 输入你的 HTTPS 域名(如
https://api.yourdomain.com)- ✅ 必须为 HTTPS 协议
- ✅ 域名需已备案(中国大陆服务器要求)
- ❌ 不支持 IP 地址或 HTTP 协议(除本地调试外)
📌 每个小程序最多可配置 20 个域名(含子域名),建议按业务模块分组配置。
三、本地开发调试(可选但推荐)
在开发阶段,若暂无正式域名,可使用以下临时方案:
- 勾选 「不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书」
(路径:开发者工具顶部栏 → 详情 → 本地设置 → 勾选该选项) - 或使用 微信提供的测试域名(仅限开发环境,上线后必须替换为正式域名)
⚠️ 此选项仅用于开发调试,正式发布前必须关闭并配置真实域名,否则小程序无法通过审核。
四、代码中使用接口地址
在 .js 文件中发起请求时,确保 URL 以配置的域名开头:
// 示例:调用已配置的 request 域名
wx.request({
url: 'https://api.yourdomain.com/user/login', // 必须是已配置的 HTTPS 域名
method: 'POST',
data: { username: 'test' },
success(res) {
console.log(res.data);
}
});
五、常见问题排查
| 问题 | 解决方案 |
|---|---|
| “不在以下 request 合法域名列表中” | 检查域名是否已在后台正确添加且为 HTTPS |
| 接口返回 404 | 确认后端服务已部署并可访问,域名解析正常 |
| iOS 设备能访问,Android 不能 | 检查是否开启 TLS 1.2+,部分旧机型需升级系统 |
| 上传/下载失败 | 分别检查 uploadFile/downloadFile 域名是否配置 |
六、上线注意事项
- 小程序提交审核前,必须关闭“不校验域名”开关
- 所有线上使用的域名必须与后台配置完全一致(包括
http/https和端口) - 如需更换域名,需重新提交审核(变更域名属于重大配置修改)
完成以上配置后,即可安全、合规地在小程序中调用自有服务器接口。如有更多场景需求(如多环境切换、动态域名等),可进一步探讨实现方案。
云小栈