微信服务号安全域名，是开发者调用微信JS-SDK接口时必须配置的域名白名单，配置后接口才能正常调用，功能才能正常使用。很多运营者第一次接触这个概念时，看着后台那一串填写框，不知道填什么、有什么用、填错了会怎样,这篇文章逐一拆解清楚。
安全域名填什么？怎么填？
安全域名本质上是一个白名单机制，你填入的域名，会被微信服务器记录下来，当你的页面通过微信内置浏览器访问时，微信会校验当前页面所在的域名，是否在已登记的白名单内，校验通过，JS-SDK的接口才能正常执行；校验不通过,接口会直接报错。
填写路径是：登录微信公众平台 → 左侧菜单“设置与开发” → “开发接口管理” → 找到“JS接口安全域名”这一项，点击修改,填入你的业务域名。
填写时有几个硬性要求,缺一不可：
- 域名必须已备案，未完成ICP备案的域名，系统会直接弹出提示，无法保存，这是硬性门槛，备案时长通常需要一到两周,需要提前规划。
- 只填域名，不填协议头和路径，常见的错误是把“https://www.example.com/index.html”整段粘贴进去，正确写法是“example.com”或“www.example.com”，不带https://,不带目录层级。
- 支持填多个域名，微信服务号最多支持配置多个安全域名，但数量有限额，具体以公众平台页面显示为准，多个域名之间，每一行填一个,用换行分隔。
- 需要下载校验文件并上传，在修改页面，微信会提供一个特定文件名的txt文件，你需要把这个文件上传到该域名根目录下，确保通过“http://你的域名/文件名.txt”能直接访问到内容，这一步是为了证明你对这个域名拥有控制权，域名根目录，指的是服务器上网站存放的根文件夹,比如Nginx指向的root目录。
填完保存后，系统会自动验证一遍文件是否可访问。校验文件必须始终保持可访问状态，不能验证通过后就删除，删了之后，后续新增或修改其他域名时,会连带校验失败。
设置安全域名，到底解决什么问题？
不配置安全域名，最直接的影响是所有依赖JS-SDK的功能都会异常，JS-SDK是微信提供的一套接口库，网页里要获取用户头像昵称、调用微信扫一扫、调起微信支付、分享自定义标题和缩略图,背后都依赖这套接口。
业内专家指出，绝大多数服务号网页功能异常，排查到最后,一半以上的原因是安全域名配置不正确或漏配。
配置安全域名主要解决以下几个核心问题：
- 保障网页内微信支付的正常调起，公众号网页支付要求当前页面域名与配置的安全域名一致，否则支付按钮点击后无反应，或直接弹“当前页面无法使用微信支付”，这是使用频率最高、最受影响的功能。
- 让自定义分享生效，不配置的话，分享给朋友或朋友圈时，卡片显示的是网页默认标题和默认图标，内容不精准，传播效果大打折扣，配置后，可以通过JS-SDK的updateAppMessageShareData和updateTimelineShareData接口，自定义分享标题、描述、缩略图和链接。
- 调用摄像头、扫码等硬件能力，比如H5页面需要扫快递单号、识别条形码，必须调用wx.scanQRCode接口，未配置安全域名，这个接口直接不执行,按钮点击无反应。
- 获取用户地理位置，部分线下业务场景，如门店导航、附近门店查询，需要获取用户经纬度，调用wx.getLocation接口,同样依赖安全域名配置。
安全域名的本质是权限开关，配置了，相当于微信认可了你的页面身份，允许接口被调用；没配置，微信不认你,接口一律拒绝。
安全域名和网页授权域名，别搞混
很多运营者会把“JS接口安全域名”和“网页授权域名”混为一谈，这两个名称长得像，位置也接近，但职责完全不同,配置错误会导致功能异常但排查不到原因。
- 网页授权域名，用于OAuth2.0网页授权，作用是让网页获取用户的基本信息，比如头像、昵称、openid，配置这个域名，网页才能正确跳转到微信的授权页面，用户同意后，微信服务器会临时回调到你配置的这个域名,并附带授权code。
- 安全域名，作用于JS-SDK接口，作用是让已经加载出来的页面，具备调用微信原生能力（分享、支付、扫码、定位）的资格。
简而言之，一个管“用户身份获取”，一个管“微信能力调用”，两者可以设置为同一个域名，也可以不同，多数情况下，会把两者都配置成同一个主域名,方便管理。
在配置时，两者的要求也有些许差异，网页授权域名
在填写时，同样要求域名已备案，但校验文件的上传位置和安全域名是一致的，修改任何一个时，都需要确保校验文件可访问，区别在于，网页授权域名有数量限制，通常比微信服务号安全域名支持的数量更少,具体以公众平台页面提示为准。
这里有一个容易踩的坑：如果网页里同时调用了获取用户信息和微信支付，两个域名的配置都需要包含当前页面域名，漏配任何一方，都会导致对应功能不可用，排查时，可以先用微信开发者工具，分别测试两个接口的返回信息,定位是哪一方的配置问题。
实际配置过程中，大家常犯的错
配置安全域名不算复杂，但实操中，几个问题反复出现,需要提前知晓。
校验文件上传了，但“文件无法访问”
这是出现频率最高的报错，文件明明通过FTP传到根目录了，微信却提示访问不到，判断方法很简单：在电脑浏览器里直接访问“http://你的域名/校验文件名.txt”,看能不能打开。
如果浏览器打不开,原因通常是：
- 文件传错了目录，传到二级目录，没有放根目录，要注意区分是服务器根目录,还是网站子目录。
- 服务器开启了防盗链或访问白名单，会拦截微信服务器的访问请求,导致校验失败。
- 域名做过CDN加速，且CDN缓存了旧内容，CDN节点上缓存的是校验文件上传前的404状态，微信访问时命中了缓存，同样报错,需要去CDN控制台刷新缓存。
很多用户用的是HTTPS访问，但校验文件访问时，微信可能走的是HTTP协议，确保HTTP和HTTPS下,这个文件都能正常打开。
提示“所属行业”不匹配
填写安全域名时，部分服务号会提示“当前账号所属行业不允许配置该域名”，这种情况多与企业主体资质有关，以“个体户”主体注册的服务号，某些行业的域名，系统会限制为无法配置，行业分类是在注册时选定的，如需变更，需要向微信提交资质证明进行修改,审核通过后才能配置对应域名。
域名数量到上限了
微信服务号安全域名支持的数量有限，如果需要接入多个业务系统，域名不够用，行业共识是提前规划域名架构，把多业务收敛到同一个主域名下的二级目录，比如把商城放在“shop.example.com”，把预约放在“booking.example.com”，统一使用“example.com”作为安全域名，通过二级路径区分业务，这样既能避开数量上限,也方便统一管理HTTPS证书。
更换服务器或域名时，安全域名要不要改？
要改，而且要提前改，不能等旧域名解析停了再改，微信公众平台修改安全域名是即时生效的，不涉及审核期，但校验文件要能正常访问,具体操作步骤：
- 在新域名根目录上传新的校验文件。
- 登录公众平台，在安全域名配置页面，追加新域名,保存。
- 确认保存成功且新域名校验通过后,再删除旧域名。
这个顺序很重要，先删旧域名的做法，如果新域名校验失败，业务功能会直接处于“裸奔”状态，如果服务器整体迁移，还需要同步确认网页授权域名、IP白名单的配置，这三者是一套组合,往往需要一并修改。
最后一个建议：安全域名配置完成后，可以用微信开发社区提供的JS-SDK功能测试页面，实际验证一下分享、扫码等接口是否能正常返回内容，比起事后排查配置问题，事前验证十分钟,能省下大量处理线上投诉的时间。
配置安全域名，是服务号开发上线前的一个关键动作，它不产生直接流量，但所有依赖微信生态能力的页面功能，都以它为前提。 忽略这个基础配置，后续线上功能出现异常的概率会大幅提高，按文中步骤逐步配置，仔细核对每一项要求,功能上线会顺畅很多。
微信服务号安全域名常见问题解答
问：微信服务号安全域名可以填几个？
答：可以配置多个，同一时间生效的域名数量以公众平台后台“JS接口安全域名”页面显示的剩余额度为准，多个域名时每行填一个,不要加逗号或空格。
问：微信服务号安全域名和网页授权域名的区别是什么？
答：安全域名管的是网页里调用微信接口（如分享、支付、扫码）的权限，网页授权域名叫用户进行微信身份授权并获取头像昵称信息，两者需要单独配置，漏配任何一个对应的功能都会异常,域名可以相同。
问：配置安全域名时，校验文件上传到哪里？
答：上传到该域名的根目录，即服务器上网站程序的存放根文件夹，上传完成后，用浏览器直接访问“http://域名/文件名.txt”能打开文件才算成功，校验文件必须永久保留,不可删除。