小程序 wx.request 全网最全避坑:为什么本地能请求,线上接口404/失败?
位置:首页
/ admin
admin
Admin
2026-08-13 14:54:26
2355
一、前言
图片有合法域名,接口同样有!很多人图片搞定了,结果接口上线直接挂掉。
二、request请求三大硬性规则(线上强制)
必须HTTPS协议,HTTP接口线上直接拦截
域名必须已备案,未备案域名无法添加到后台
必须配置request合法域名
三、完整配置步骤
1. 登录小程序后台 → 开发 → 开发设置 → 服务器域名
2. 在「request合法域名」填写你的接口根域名
示例:https://api.xxx.com
3. 保存后,开发者工具刷新配置,重新编译即可
四、常见报错解读
errMsg:request:fail invalid domain → 域名未配置/不是https
request:fail ssl handshark error → 服务器SSL证书过期/不合法
404 Not Found → 接口地址路径错误,和小程序配置无关
403 Forbidden → 服务器拦截了小程序请求(跨域/白名单)
五、个人开发者终极方案
不想备案、不想买服务器:直接使用小程序云函数做中间层,云函数发起请求不受合法域名限制,完美绕过所有域名限制!
上一篇: 没有了!