接口配置

接口能在浏览器打开,不代表小程序一定能请求。

微信小程序访问后端接口前,需要在小程序后台配置合法域名。这个限制是为了让小程序只能访问明确授权的服务器。

合法域名到底管什么

配置项常见用途例子
request 合法域名wx.request 调用后端 APIhttps://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后端是否允许当前请求
开发者工具里能临时勾选“不校验合法域名”,但这只适合调试。真机、体验版、审核和正式版必须按线上要求配置。

给 AI 的正确描述

不要只说“小程序请求失败”。更有效的描述是:请求地址是什么、当前环境是开发者工具还是真机、报错内容是什么、后台是否配置了 request 合法域名、证书是否正常。这样 AI 才能判断是代码问题、配置问题,还是服务器问题。

小程序网络官方文档返回知识库