errMsg: "request:fail url not in domain list"

Question

微信小程序部署后连接不上后台
1.本地调试ok，取消了不检验域名端口
2.部署后报错，errMsg: "request:fail url not in domain list"，接口没发到后台
3.真机调试也ok

Answer 1

上午好☀️☀️☀️️
本答案参考通义千问

你遇到的问题是：微信小程序部署后连接不上后台，提示 errMsg: "request:fail url not in domain list"。这个问题通常是因为 小程序的合法域名未正确配置 或 请求的接口地址不在合法域名列表中。

---

一、问题原因分析

1. 本地调试时，微信开发者工具默认关闭了域名校验，所以可以正常访问。
2. 部署到正式环境后，微信会严格校验域名是否在合法域名列表中。
3. 如果请求的 URL 不在合法域名中，就会报错：request:fail url not in domain list。
4. 真机调试也 OK 的情况可能是使用了测试域名或未启用正式域名校验。

---

二、解决方案（重点部分加粗）

1. 检查并配置合法域名

• 登录 微信公众平台。

• 进入【开发管理】->【开发设置】。

• 在【服务器域名】中检查以下内容：

  • request合法域名：必须包含你请求的 API 接口地址（如 https://api.example.com/xxx）。
  • 注意：域名必须为 HTTPS 协议，并且不能带端口号（除非是 443 端口）。

  重要：域名必须与实际请求的 URL 完全匹配，例如：

  • 如果你请求的是 https://api.example.com/user/login，那么你的合法域名应为 https://api.example.com。
  • 不能只填写 api.example.com，必须带上 https://。

---

2. 配置服务器域名时注意事项

| 类型 | 要求 | |------|------| | HTTPS | 必须使用 HTTPS 协议 | | 域名格式 | 必须是完整的域名，如 https://api.example.com | | 不能有路径 | 如 https://api.example.com/api 是不允许的 | | 不能有端口 | 如 https://api.example.com:8080 是不允许的 |

✅ 正确示例：https://api.example.com

❌ 错误示例：api.example.com、https://api.example.com/api、https://api.example.com:8080

---

3. 修改代码中请求的 URL

确保你的小程序代码中的请求地址与合法域名一致：

wx.request({
  url: 'https://api.example.com/user/login', // 必须和域名一致
  method: 'POST',
  data: {
    username: 'test',
    password: '123'
  },
  success(res) {
    console.log(res.data);
  },
  fail(err) {
    console.error('请求失败:', err.errMsg);
  }
});

如果你使用的是测试域名（如 localhost），可以在开发者工具中勾选【不校验合法域名、HTTPS 证书】进行测试。

---

4. 使用云开发或测试域名（临时方案）

如果你只是在测试阶段，可以考虑以下方式：

a. 使用微信云开发

• 微信云开发自带域名，无需手动配置。
• 适用于小型项目或测试阶段。

b. 使用测试域名（仅限开发者工具）

• 在开发者工具中，勾选【不校验合法域名、HTTPS 证书】。
• 但正式发布后必须配置合法域名。

---

5. 部署后仍报错？请检查以下内容

| 检查项 | 说明 | |--------|------| | 域名是否已提交审核 | 微信需要审核通过后才生效 | | 是否使用了正确的域名 | 确保代码中请求的 URL 和配置的域名一致 | | 是否使用了 HTTPS | 所有请求必须使用 HTTPS | | 是否有拼写错误 | 检查域名拼写是否正确（如大小写、字符等） |

---

三、总结

解决 request:fail url not in domain list 的关键步骤如下：

1. 登录微信公众平台，进入【开发设置】，配置合法域名。
2. 确保请求的 URL 与合法域名完全一致（包括协议、域名、无路径、无端口）。
3. 修改代码中请求的 URL，确保其符合要求。
4. 测试阶段可暂时关闭域名校验，但正式发布必须配置合法域名。

---

四、示例代码（修改后的请求）

// 小程序页面 JS 文件
Page({
  onLoad() {
    wx.request({
      url: 'https://api.example.com/user/login', // 注意这里必须和合法域名一致
      method: 'POST',
      data: {
        username: 'test',
        password: '123'
      },
      success(res) {
        console.log('请求成功:', res.data);
      },
      fail(err) {
        console.error('请求失败:', err.errMsg);
      }
    });
  }
});

---

如果你还有其他问题，比如域名配置失败、无法提交审核等，也可以继续提问！