一、前言
在小程序中有这样两个域名设置:服务器域名和业务域名
其实它这写的很清楚了:
"配置服务器域名后,可以小程序进行网络通信";
"配置业务域名后,可调用web-view组件在小程序中打开"。
但是对于初学者来说,这两个域名配置着实可以把人绕晕,尤其是业务域名那个万恶的校验文件,虽然微信官方也写了校验文件检查失败自查指引,但是没有什么作用。下面说说这两个域名怎么配置吧。
二、服务器域名
每个微信小程序需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信。包括普通 HTTPS 请求([wx.request、上传文件([wx.uploadFile、下载文件(wx.downloadFile) 和 WebSocket 通信(wx.connectSocket)。
配置流程
服务器域名请在 「小程序后台 - 开发 - 开发设置 - 服务器域名」 中进行配置,配置时需要注意:
- 域名只支持 https (wx.request、wx.uploadFile、wx.downloadFile) 和 wss (wx.connectSocket) 协议;
- 域名不能使用 IP 地址(小程序的局域网 IP 除外)或 localhost;
- 可以配置端口,如 myserver.com:8080,但是配置后只能向 myserver.com:8080 发起请求。如果向 myserver.com、https://myserver.c... 等 URL 请求则会失败。
- 如果不配置端口。如 myserver.com,那么请求的 URL 中也不能包含端口,甚至是默认的 443 端口也不可以。如果向 myserver.com:443 请求则会失败。
- 域名必须经过 ICP 备案;
- 出于安全考虑,api.weixin.qq.com 不能被配置为服务器域名,相关 API 也不能在小程序内调用。 开发者应将 AppSecret 保存到后台服务器中,通过服务器使用 getAccessToken 接口获取 access_token,并调用相关 API;
- 不支持配置父域名,使用子域名。
- 请求与上传的域名需要单独配置,如果你的请求与上传都是同一个域名,那么要配置两次。
- 任何与小程序有数据交互的域名都需要配置,如cdn、三方网站等
总体来说,服务器域名理解起来不难,配置上也没有一些隐藏问题,除非域名写错,多了个空格或特殊符号啥的。
三、业务域名
1. 为什么要配置
在我们实际开发的过程中,有些场景需要从微信小程序跳转到H5页面,使用web-view组件就可以了,这相当于直接跳转到了外部链接。 但是由于网络安全问题日益严峻,很多网站在你点击了外跳都会询问是否外跳,并让你签署免责声明。 微信小程序官方为了保证外跳是安全的,就出了这么一个规定:所有外跳的链接域名都需要配置安全校验文件,如果配置不了那就不要跳
。这种一刀切的方式可苦了我们这些开发者。
2. 配置文件的两种方式
(1)文件上传到域名的根目录下
这种方式主要是下载文件然后上传,需要注意的是要设置正确路由
(2)自己写一个接口返回校验文件中的字符串
由于微信这个校验文件只需要判断你返回的字符串是不是文件中的内容,所以我们可以换一个思路: 把校验的内容加到配置文件,直接通过接口返回。
这个方案我试过,是可行的,不过也踩了一些坑,这里记录一下,方便自己也方便后人。
废话不多说,直接上代码:
java
@RestController
@RequestMapping("/")
public class WeChatDomainCheckController {
@RequestMapping(value = "/{extension:.+.txt}", method = RequestMethod.GET, produces = MediaType.TEXT_PLAIN_VALUE)
public Object checkDomain(@PathVariable String extension) {
return "校验文件中的字符串";
}
}
value = "/{extension:.+.txt}"是请求的一种通配符写法,意思是可以让所有以txt结尾的请求访问
注意:
- 不要自己加子路径,因为该校验文件访问是:www.test.com/aaa.txt。 一旦加了子路径它就找不到了;
- 可以通过VM模板返回该字符串,但是记住不要添加任何多余的内容;
- 有时候明明写的没问题,但是配置的时候就是报错,这里我建议不要使用返回值的方式,可以使用
httpServletResponse.getWriter().print("校验文件中的字符串");
返回。出现这种情况的原因,是有可能是自己在项目中加了HttpMessageConverters的原因
四、微信开发者工具
微信开发者工具开发时可以跳过域名校验
已配置的request合法域名和web-view(业务域名)也可以在开发工具上看到
五、遇到的一些问题
第一个
最近有位老哥也来问我这个东西有没有其他办法,我思考了一下,尝试将外部跳转的域名嵌入到自己的域名页面中,并将校验文件配置到自己的域名下,但是还是不行,真的艹蛋。
还是老老实实配置校验文件吧。