> 技术文档 > 微信小程序合法域名配置全流程:从开发到上线的域名设置教程_微信小程序配置服务器域名

微信小程序合法域名配置全流程:从开发到上线的域名设置教程_微信小程序配置服务器域名


微信小程序域名合法列表配置问题解决方案

错误提示http://localhost:5000 不在以下 request 合法域名列表中是微信小程序开发中常见的网络配置问题。这是因为微信小程序对网络请求的域名有严格限制,必须在小程序管理后台提前配置合法域名。以下是详细的解决步骤:

一、问题原因分析

  1. 域名未配置:微信小程序不允许向未在后台注册的域名发送网络请求(包括localhost和本地端口)。
  2. 开发环境与生产环境差异:即使在开发工具中开启了「不校验合法域名」,正式发布后仍需遵守域名限制。
  3. 域名格式错误:配置的域名必须是https 协议,且不带端口号(如https://example.com,而非https://example.com:8080)。

二、解决方案:配置合法域名

1. 登录微信小程序管理后台
  • 访问微信公众平台,登录你的小程序账号。
  • 进入开发 > 开发管理 > 服务器域名
2. 添加合法域名
  • request 合法域名栏点击修改,输入你的域名(如https://api.example.com</