微信小程序URL(服务器地址)怎么填?简单说,填你后端接口的正式域名,格式为https://你的域名,需要在微信公众平台后台的「服务器域名」里配置,还要通过域名校验。
很多人第一次配置小程序时,在后台翻半天找不到“服务器地址”输入框,以为是自己眼神不好,其实微信从来没给你留过那种简陋的地址栏,你需要去「开发管理 → 开发设置 → 服务器域名」里操作,下面把整个流程摊开讲,包括填什么、在哪填、填错了怎么排查,一次说透。
微信小程序URL(服务器地址)怎么填:先搞懂填什么
很多教程上来就让你填域名,但没解释为什么不能填IP,这里先说结论:服务器地址只能填已备案的HTTPS域名,不能填IP地址,不能带路径,也不能用http://开头。
服务器地址的实际填写位置
微信开发者工具里那个“URL”输入框,通常指的是wx.request接口里的url参数,但在正式发布前,你必须先在公众平台完成域名配置,否则真机预览会直接报错。
操作路径:登录微信公众平台 → 左侧菜单「开发」→「开发管理」→「开发设置」→ 找到「服务器域名」栏目 → 点击「修改」→ 在「request合法域名」里填入你的地址。
URL的标准格式拆解
一个合格的服务器URL包含三部分:协议头 + 域名 + 可选端口。
- 协议头:必须是
https://,微信强制要求,http://会被拦截 - 域名:必须是在工信部完成ICP备案的域名,例如
api.example.com - 端口:默认443端口可以省略,如果用了其他端口如
https://api.example.com:8443,端口号也要写上去
这里要提醒一个细节:域名不能带路径。https://api.example.com/user这种写法是错误的,路径要放在代码里,后台只配置到域名这一层。
为什么必须是HTTPS加密域名
微信要求所有请求走HTTPS,目的是防止数据在传输过程中被窃取或篡改,给域名配置SSL证书是硬性要求,现在市面上有免费的证书服务,个人开发者用免费版就够了,据行业观察,相当一部分开发者第一次报错,就是因为在后台填了http://开头的地址。
微信小程序request合法域名怎么设置:三步完成配置
第一步:后台添加域名
进入「服务器域名」修改页面后,在request合法域名列表里填入你的域名,如果你还需要上传文件或下载文件,对应的uploadFile合法域名和downloadFile合法域名也要分别配置,规则类似。
第二步:下载校验文件并上传
添加完域名后,微信会要求你证明这个域名是你自己的,具体做法是:点击「下载校验文件」,得到一个txt文件,把它放到你域名的根目录下,确保通过浏览器能访问到这个文件,确认无误后,回到后台点击「保存」。
第三步:开发工具里关闭域名校验
在开发调试阶段,你可以先不用急着配域名,直接在微信开发者工具的「详情 → 本地设置」里勾选「不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书」,这样开发时能省去不少麻烦。但注意,这个选项只对开发工具生效,真机预览和线上版本依然要过域名校验这一关。
小程序服务器域名配置方法:从开发到上线的完整流程
本地开发阶段怎么填URL
本地开发时,如果你用的是局域网IP,比如http://192.168.1.100:3000,只要勾选了不校验域名,代码里的请求地址可以随便写,但为了方便后续切换,建议在代码里维护一个API地址配置文件,把开发环境和生产环境的URL分开管理。
测试环境建议用二级域名
如果你的生产域名是api.example.com,测试环境就别用同一个域名了,申请一个test-api.example.com二级域名,分别配置不同环境的SSL证书,这样在真机预览时,可以清楚地知道当前请求打到的是哪套环境,排查问题不混淆。
正式上线前的检查清单
- 检查域名是否完成ICP备案,服务器位于境内时必须备案,境外服务器不需要备案但响应速度可能受影响
- 确认SSL证书有效期为覆盖到上线日期之后,常用证书平台都有到期提醒
- 在后台重置域名配置后,测试工具会重新校验文件是否存在
- 清除开发工具的缓存后重新编译
| 配置项 | 开发模式 | 正式环境 |
|---|---|---|
| 请求协议 | http/https均可 | 必须https |
| 域名要求 | 无限制 | 已备案、有证书 |
| 是否需要校验 | 可勾选跳过 | 必须通过校验 |
| 常见端口 | 3000/8080等 | 443或自定义 |
个人开发者的成本参考
个人做小程序,域名一年几十块,免费SSL证书就够了,真正花钱的地方是服务器,国内云厂商的基础款云服务器年费在百元级别,你要真不想买服务器,也可以用云开发,不用配置域名,直接在云函数里写接口,但如果你用云开发,就不存在wx.request填URL的问题了,接口路径是另一套写法。
填错了怎么排查:常见报错与解决方案
报错:不在以下request合法域名列表中
这个错误最常见,意思是你的域名没配好,解决方案:
- 登录后台,确认域名已添加到request合法域名列表中
- 确认域名前面带了
https://,后台不识别http:// - 确认校验文件还在域名根目录
报错:TLS版本过低或不支持
微信要求TLS 1.2及以上版本,老服务器的默认配置可能是TLS 1.0或1.1,你需要去Web服务器配置文件里调整协议版本,比如Nginx配置:
ssl_protocols TLSv1.2 TLSv1.3;
改完记得重载配置。
真机预览请求失败,开发工具却正常
这大概率是开发工具勾了不校验域名,真机没勾,还有一种可能性是,你的域名没有备案,微信在真机上做了更严格的校验,近年来的行业共识是,境内服务器的备案检查越来越严,没备案的域名基本不可能在小程序里正常请求,你可以临时用局域网IP加http://测试,但这不是长久之计,早点搞定备案才是正路。
检查SSL证书链是否完整
有相当一部分人遇到的问题是:证书本身有效,但证书链不完整,浏览器能访问,微信却报错,可以使用一些在线的SSL检测工具,查一下证书链是否包含中间证书,不完整的,去证书服务商那里下载完整证书链文件重新配置。
关键点回顾:微信小程序服务器地址配置不可忽视的细节
整体来看,微信小程序URL填写的核心就三个约束:协议必须是HTTPS、域名必须备案、域名必须通过后台校验,不管你是个人开发者还是企业团队,这套逻辑都一样。
对于域名放在境外的团队,建议实测一下访问速度,境外服务器可以绕过备案,但请求延迟对用户体验的影响直接,如果目标用户都在国内,还是老老实实买境内服务器加备案,别省这个麻烦,业内专家指出,小程序审核时如果发现请求地址不稳定或频繁超时,被拒的风险不小。
最后再唠叨一句:整理一份自己的域名配置清单,把后台修改时间、证书到期时间、域名注册商账号都记下来,这些信息平时用不上,一旦出问题要找配置记录,能省半天时间,配置完成后,重新编译并真机预览一次,确认请求正常再提交版本。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/798183.html


