3.4 KiB
3.4 KiB
微信小程序域名配置要求
问题分析
在真机调试时，https://green.hrln.com.cn 可以正常请求，但 https://green-dev.cyweb.top 不能正常请求，这是因为小程序对服务器域名有严格的安全要求。
小程序域名配置要求
1. 必须在微信公众平台配置合法域名
小程序在真机上运行时，只能请求在小程序后台配置的合法域名。配置步骤：
- 登录 微信公众平台
- 进入小程序管理后台
- 点击左侧菜单「开发」→「开发管理」→「开发设置」
- 找到「服务器域名」配置项
- 在「request合法域名」中添加：
https://green-dev.cyweb.top- 注意：只需要填写域名，不需要带路径，如
https://green-dev.cyweb.top（不要写成https://green-dev.cyweb.top/api）
- 注意：只需要填写域名，不需要带路径，如
2. 域名必须满足以下条件
- ✅ 必须使用 HTTPS 协议（不支持 HTTP）
- ✅ 域名必须经过 ICP 备案（国内服务器）
- ✅ SSL 证书有效且未过期
- ✅ 域名格式正确（不包含路径，如
https://green-dev.cyweb.top）
3. 域名校验文件（如需要）
添加域名时，微信可能会要求：
- 下载校验文件（如
MP_verify_xxxxx.txt） - 上传到服务器的根目录（如
https://green-dev.cyweb.top/MP_verify_xxxxx.txt） - 确保可以通过浏览器访问该文件
4. 开发工具 vs 真机的区别
- 开发工具：可以通过
project.config.json中设置"urlCheck": false跳过域名校验 - 真机调试/正式版：必须在小程序后台配置合法域名，否则请求会被拦截
当前项目配置
代码中的域名使用
// src/utils/request.js
const BASE_URL = 'https://green-dev.cyweb.top/api'
需要配置的域名
在小程序后台的「request合法域名」中需要添加：
https://green-dev.cyweb.top
注意：配置时只填写域名部分（https://green-dev.cyweb.top），不要包含路径（/api）。
解决方案
方案 1：配置开发域名（推荐）
- 登录微信公众平台
- 在「开发设置」→「服务器域名」中添加：
https://green-dev.cyweb.top
- 如果提示需要校验文件，按要求上传
- 等待配置生效（通常几分钟内）
方案 2：使用已配置的域名
如果 https://green.hrln.com.cn 已经配置好，可以考虑：
- 临时使用该域名进行开发测试
- 或者让后端在该域名下提供代理接口
方案 3：使用体验版/开发版
- 体验版和开发版可以使用已配置的合法域名
- 真机预览时，确保使用正确的 AppID 和版本
常见问题
Q: 为什么开发工具可以请求，真机不行？
A: 开发工具可以通过 urlCheck: false 跳过校验，但真机必须配置合法域名。
Q: 域名配置后多久生效？
A: 通常几分钟内生效，最长可能需要 24 小时。
Q: 可以配置多个域名吗？
A: 可以，最多可以配置 20 个 request 合法域名。
Q: 域名必须备案吗？
A: 是的，小程序要求服务器域名必须经过 ICP 备案（国内服务器）。
检查清单
- 域名已在小程序后台「request合法域名」中配置
- 域名使用 HTTPS 协议
- 域名已通过 ICP 备案
- SSL 证书有效
- 如需要，已上传域名校验文件
- 等待配置生效后重新测试