Skip to content

问题现象 ​

在微信开发者工具或真机中运行打包后的小程序时,页面提示 网络开小差了、网络连接失败 或控制台所有 API 请求均返回 fail。


根本原因与排查步骤 ​

检查前端接口基础域名配置 ​

打开移动端工程源码 view/uniapp/config/app.js(或生产环境配置文件):

javascript
// 必须配置为线上真实的后端 HTTPS 域名
const HTTP_REQUEST_URL = 'https://www.yourdomain.com';
  • 检查要点:
    • 必须以 https:// 开头。
    • 末尾严禁带斜杠 /。
    • 不要使用 127.0.0.1、localhost 或未备案的 IP 地址。

检查微信公众平台【request 合法域名】 ​

登录微信小程序管理后台 -> 【开发管理】 -> 【开发设置】 -> 【服务器域名】,确认 request 合法域名 中已添加了上述填写的域名。


检查 Nginx 反向代理与 SSL 状态 ​

在电脑浏览器中直接访问后端的 API 根路径(例如 https://你的域名/api/category):

  • 若浏览器提示 SSL 证书不安全或返回 502/500,需先修复服务器端的 Nginx 反向代理与 SSL 证书。
  • 确认修改配置后重新执行了小程序编译构建并在开发者工具中重新上传代码。

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心