接口配置
接口能在浏览器打开,不代表小程序一定能请求。
微信小程序访问后端接口前,需要在小程序后台配置合法域名。这个限制是为了让小程序只能访问明确授权的服务器。
合法域名到底管什么
| 配置项 | 常见用途 | 例子 |
|---|---|---|
| request 合法域名 | wx.request 调用后端 API | https://api.example.com |
| uploadFile 合法域名 | 上传图片、资料、附件 | https://upload.example.com |
| downloadFile 合法域名 | 下载文件、图片或导出内容 | https://cdn.example.com |
| socket 合法域名 | 实时通信 | wss://socket.example.com |
如果你的预约接口是 https://api.example.com/api/bookings,那么小程序后台配置的通常是域名部分,而不是完整接口路径。
排查请求失败,先看这条链路
01接口是否 HTTPS
02域名是否已备案
03是否配置到小程序后台
04证书是否有效
05后端是否允许当前请求
开发者工具里能临时勾选“不校验合法域名”,但这只适合调试。真机、体验版、审核和正式版必须按线上要求配置。