加油
努力

微信小程序如何配置自己的服务器域名和接口地址?

在微信小程序中配置服务器域名和接口地址,需要完成后台配置代码开发两部分工作。以下是详细步骤:


一、登录微信公众平台

  1. 访问 微信公众平台
  2. 使用小程序管理员账号扫码登录

二、配置服务器域名(关键步骤)

⚠️ 注意:从微信开发者工具 v2.0+ 开始,所有网络请求的域名必须在「开发设置」中提前配置,否则无法调用 wx.request 等接口。

操作步骤:

  1. 进入左侧菜单:开发 → 开发管理 → 开发设置
  2. 找到 「服务器域名」 区域
  3. 点击对应分类下的 添加按钮
    • request 合法域名(用于 wx.request
    • socket 合法域名(用于 WebSocket)
    • uploadFile 合法域名(用于文件上传)
    • downloadFile 合法域名(用于文件下载)
  4. 输入你的 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 和端口)
  • 如需更换域名,需重新提交审核(变更域名属于重大配置修改)

完成以上配置后,即可安全、合规地在小程序中调用自有服务器接口。如有更多场景需求(如多环境切换、动态域名等),可进一步探讨实现方案。

云服务器