微信小程序配置服务器域名详细图文教程

前言

在小程序中使用网络相关的 API 时，要预先配置好需要进行网络通信的服务器域名，包括普通 HTTPS 请求（wx.request）、上传文件（wx.uploadFile）、下载文件（wx.downloadFile) 和 WebSocket 通信（wx.connectSocket）。

1 打开服务器域名配置

首先登录“微信公众平台”，点击侧边导航栏的“开发管理”，选择“开发设置”。

找到“服务器域名”，点击修改按钮，扫码进行身份验证，就可以进行服务器域名配置。

根据你的网络请求，配置对应的服务器域名，点击保存并提交，配置成功。

2 配置业务域名

若小程序中有使用到webview，则还需要配置业务域名。找到“业务域名”，点击修改按钮，扫码进行身份验证。

配置业务域名后，点击下载校验文件，将下载后的校验文件复制到相关域名的根目录下，点击保存即可。

附：常见错误及原因分析：

常见错误提示

原因及解决方法

该域名协议头非法

域名内包含非法的协议头，请修改

域名中不能含有端口号

域名内含有端口号，请修改

不能使用IP地址作为域名

IP地址不能作为域名，请修改

不能使用本地域名localhost

小程序服务器配置域名不可使用本地域名，请修改

为保障平台安全，请更换域名地址

此域名地址不可被设置，请修改

该域名包含非法字符，只支持英文大小写字母、数字及“-”

域名内包含非法字符，请修改

操作频繁，请稍后重试

在一定时间周期内提交修改过于频繁，请稍后再试

该域名因违规被禁止设置。如有异议，请在微信客户端打开该域名进行申诉

该域名在微信内存在违规行为，请用微信客户端打开此域名，在错误页面中发起申诉。申诉通过后即可重新填写。

该域名未备案

填写的域名未经过icp备案，请先完成域名备案，再重新填写

为保障账号安全不可使用此域名地址，请修改

如填写了“api.weixin.qq.com”会出现上述错误提示。出于安全考虑，为避免开发者将AppSecret放置在小程序的前端代码内，平台禁止设置此域名。小程序的开发者密码（AppSecret）是一个非常重要的字段，使用该密码可以调用小程序的所有后台接口。请不要将该字段放置在微信小程序的前端代码中，因为微信手机客户端容易被反编译并轻松获得Appsecret，造成重大的安全威胁。开发者应将Appsecret保存到后台服务器中，通过服务器使用Appsecert获取Accesstoken。微信公众平台小程序后台的服务器地址设置也将禁止将“api.weixin.qq.com”域名的配置，所有对于“api.weixin.qq.com”域名下的接口请求请全部通过后台服务器发起，请勿直接通过小程序的前端代码发起。

该域名所在的服务平台或网页存在大量违规内容，已被禁止设置。如有异议，请联系服务平台或网页运营者对违规内容进行整顿后，在微信客户端打开该域名申请恢复。

该域名为云平台域名，且该云平台/网页存在大量违规内容，不可设置。开发者可联系云平台或该网页运营者对违规内容进行整顿后，在微信客户端内打开此域名，并在错误页面中发起申诉。申诉通过后即可重新填写。

此域名为开发环境域名，不可在正式环境下使用，请修改

此域名是腾讯云开发环境域名，不可用在正式环境下，请修改。