AI寰宇空间

Appearance

后端接口访问分为开发环境和正式环境

一、 开发环境 ​

提示

在开发环境中，小程序可以使用 localhost 或 ip 作为后端接口的域名。
但是需要在【微信开发者工具-详情-本地设置】中勾选【不校验合法域名、web-view(业务域名)、TLS版本以及 HTTPS 证书】。

微信开发者工具可以临时跳过域名校验：

  1. 点击开发者工具 右上角「详情」→「本地设置」
  2. 找到 「不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」
  3. ✅ 勾选这个选项
  4. 现在直接把你代码里的接口地址，从 http://localhost:xxxx 改成你的主机 IP / 域名即可，比如：
js
// 之前的本地地址
// const baseURL = 'http://127.0.0.1:8080/api'

// 改成你的主机地址（IP或域名都可以，HTTP/HTTPS都可以）
const baseURL = 'http://你的服务器公网IP:端口/api'
// 或者 const baseURL = 'https://你的域名/api'
  1. 重新编译项目，立刻就能访问主机接口，不需要任何其他配置

⚠️ 注意：这个方法只能在开发工具里用，真机预览 / 正式发布时会失效

二、 正式环境 ​

提示

根据微信小程序官方文档，后端接口访问应该注意以下问题：

  1. 接口调用不能使用 IP 地址（小程序的局域网 IP 除外）或 localhost；
  2. 域名必须在小程序管理后台「小程序后台-管理-开发管理-服务器域名」配置；
  3. 域名只支持 https (wx.request、wx.uploadFile、wx.downloadFile) 和 wss (wx.connectSocket) 协议；
  4. 域名必须经过 ICP 备案；
  5. 不支持配置父域名，使用子域名；

步骤 1：先准备好你的服务器环境 ​

  1. 你的主机 / 服务器必须已经安装好 SSL 证书，支持 HTTPS 访问
  2. 你的域名已经完成工信部备案（微信要求必须备案，未备案域名无法通过）
  3. 接口可以通过 https://你的域名 正常访问（浏览器里先测试能打开）

步骤2：在微信公众平台配置合法域名 ​

  1. 打开 微信公众平台 并登录你的小程序账号

  2. 左侧菜单点击 「开发」→「开发管理」→「开发设置」

  3. 拉到页面中间找到 「服务器域名」 板块，点击「修改」

  4. 在 「request合法域名」 里填入你的接口域名：

    js
    https://你的域名.com

注意

  • 必须是https://开头，不能带端口（默认443）
  • 不能填IP地址，必须是备案过的域名
  • 多个域名用换行分隔
  1. 点击「保存并提交」，配置后10分钟左右生效

步骤3：修改代码里的接口地址 ​

把项目里所有接口的baseURL改成你的正式HTTPS域名：

js
// 正式环境地址（必须是HTTPS的备案域名）
const baseURL = 'https://你的域名.com/api'

三、Nginx配置SSL实操 ​

前往：网站搭建/Nginx/https域名配置