JS接口安全域名申请的核心动作只有两步：在微信公众平台后台填写已验证归属的域名，并把官方生成的txt校验文件上传到该域名根目录，保存后接口即可生效。 很多开发者反复卡住，往往不是流程复杂，而是验证文件路径多了一层子目录，或者域名格式多写了http://，下面按真实配置场景把申请流程、验证位置、常见差异一次说清。
微信js接口安全域名怎么申请？后台配置与验证文件完整步骤
先登录微信公众平台,左侧菜单进入“设置与开发”→“公众号设置”→“功能设置”，页面下拉找到“JS接口安全域名”，这个入口不显眼，藏在一堆功能开关里，不熟悉后台的人第一次找会花点时间。
第一步：定位“JS接口安全域名”设置入口
公众号后台功能设置区会同时展示“业务域名”“JS接口安全域名”“网页授权域名”三个卡片，三个都涉及域名，但用途完全不同，需要申请的是中间那个带“JS接口安全域名”字样的卡片，点击卡片右侧的“设置”或“修改”按钮，会弹出一个配置弹窗。
第二步：下载官方校验文件
点击设置后,弹窗里会显示一个随机命名的txt文件，文件名通常以“MPverify”开头，后面跟一串字符，这个文件是微信校验域名归属的唯一凭证，先把它下载到本地，文件内容不要做任何修改，文件名大小写也不能变。
第三步：上传验证文件到域名根目录
这里是最多人出错的地方,官方要求校验文件必须能通过你的域名/MP_verify_xxxxx.txt这样的地址直接访问到。
- 正确位置：域名根目录，例如服务器上的
/www/wwwroot/yourdomain.com/目录下直接放文件。 - 错误位置：子目录如
/public/、/dist/、/static/下面，访问路径会变成/public/MP_verify_xxxxx.txt，校验不通过。 - 如果使用nginx或apache,要注意不要把txt请求重定向到index.html，可以先用手机或电脑浏览器直接访问该txt地址，确认能显示文件内容，而不是404或跳转首页。
- 如果域名配置了强制https跳转,确保http和https都能访问到该txt文件，部分校验会先尝试http。
第四步：填写域名并保存
回到微信后台弹窗,在输入框里填写域名，这里只填写纯域名，例如
yourdomain.com，不要带http://、https://，也不要带端口号，如果网站主域名为www.yourdomain.com，而网页实际部署在yourdomain.com，两个要分别考虑，通常填不带www的根域即可覆盖，填完后点保存，微信会立即发起校验。
js接口安全域名验证文件放在哪里才生效？根目录不是子目录
这个疑问的答案很直接：文件必须放在域名根目录，保证浏览器访问你的域名/MP_verify_xxx.txt时能直接读到原始文件内容，放在任何子目录、通过路由转发、用CDN缓存旧内容，都可能导致验证失败，校验通过后文件可以保留，不要删除，因为修改域名或重新校验时还会用到。
js接口安全域名和业务域名区别：填错位置会直接拦截接口
两个名词经常被一起提起,但作用完全不同，把JS接口安全域名填到业务域名里，网页里的分享、扫码等JS-SDK接口会被直接拦截；反过来填错也会导致微信内置浏览器打不开页面。
| 对比项 | JS接口安全域名 | 业务域名 |
|---|---|---|
| 主要用途 | 控制网页调用微信JS-SDK接口权限 | 控制微信内置浏览器可访问的网页域名 |
| 典型场景 | 自定义分享、微信扫一扫、图像上传、音频播放 | 在微信里打开H5活动页、商城页、文章页 |
| 验证文件 | 需要下载MP_verify开头txt文件上传根目录 | 需要下载另一个校验文件上传根目录，和JS接口文件不通用 |
| 填写位置 | 公众号设置→功能设置→JS接口安全域名 | 公众号设置→功能设置→业务域名 |
| 数量限制 | 一般支持填写多个域名，以后台实际输入框提示为准 | 同样支持多个，但两个体系独立计数 |
| 是否必须同时配置 | 只有使用JS-SDK时才需要 | 只有需要在微信内访问网页时才需要 |
简单说,业务域名管“网页能不能在微信里正常打开”，JS接口安全域名管“网页里能不能调用微信原生能力”，两者校验文件放在同一个域名根目录下，但文件名不同，不能混用，多数公众号如果只做菜单跳转网页、不做分享定制，可以先只配置业务域名；一旦需要自定义分享文案或调用扫一扫，就必须再申请JS接口安全域名。
企业微信js接口安全域名申请流程：上海公司可复用的配置路径
企业微信自建应用里的JS接口安全域名,和公众号后台的配置逻辑接近，但路径不同，以上海一家软件公司配置自建H5应用为例，操作路径如下：
- 登录企业微信管理后台,进入“应用管理”→“自建”，找到目标应用。
- 点击应用进入详情,找到“网页授权及JS-SDK”区域。
- 在“可信域名”或“JS接口安全域名”输入框中填写域名，格式同样不带协议头。
- 下载校验文件,上传到域名根目录，企业微信的校验文件名一般也是txt格式，命名规则略有差异，以上传时系统实际生成的文件为准。
- 保存后系统自动校验,校验通过即生效。
上海公司的实际部署里,如果域名放在华东云服务器上，且已经完成ICP备案，整个流程在半小时内可以走完，如果域名未备案或备案主体与企业微信认证主体不一致，校验会被拒绝，这一点在多地都有同样要求，不只是一个地域的限制。
js接口安全域名最多几个？修改后多久生效？
这个问题经常出现在首次配置失败之后的搜索里,实际数量限制以微信公众平台后台输入框下方提示为准，不同账号类型可能会有差异，一般支持填写多个域名，填写时用回车或分号分隔，首次配置成功后，修改域名同样需要重新上传校验文件并保存。
修改后的生效时间没有统一秒级标准,多数情况下，微信后台提示保存成功后接口权限会立即更新，但因为CDN、浏览器缓存和微信客户端缓存的存在，实际调用新域名接口可能在几分钟到几十分钟内逐步生效，遇到延迟，可以尝试清理微信缓存或重新进入网页，行业共识认为，只要校验文件可访问、域名格式正确、备案状态正常，申请通过率会稳定在一个较高水平。
常见失败场景与排查思路
把申请过程中反复出现的问题拆开看,基本集中在域名格式、验证文件路径、备案状态和https证书四类。
- 域名格式多写http://：输入框只认纯域名，
http://yourdomain.com会被直接判定为无效格式。 - 验证文件藏在子目录：例如Vue项目构建后放在
dist
dist外面，但访问路径实际指向public，就永远校验不到。 - 域名未备案或备案被注销：国内服务器上的域名未完成ICP备案，微信会直接拒绝，这一点官方后台有明确提示。
- https证书链不完整：如果配置了https，证书链缺失会导致部分接口校验请求失败，可以用浏览器检查证书详情是否显示“有效”。
- CDN缓存了txt文件旧内容本身不会变，但如果CDN把txt当作静态资源缓存，且之前返回过404，会长时间返回404，可以刷新CDN缓存或在txt文件请求上禁用缓存规则。
排查顺序建议从简单到复杂：先浏览器访问验证文件URL，再检查后台域名格式，最后查备案和证书，大部分一次未通过的情况，改完这些项后第二次就能通过。
JS接口安全域名申请不是技术含量很高的操作,但对路径和格式极其敏感，把“纯域名填写”和“根目录放txt”这两件事做对，基本不会卡关，配置完成后，开发者在网页里引入JS-SDK，绑定同一域名即可正常调用微信原生接口。
Q&A
Q：js接口安全域名怎么申请才能一次通过校验？
A：先确认域名已完成ICP备案，再进入微信公众平台“设置与开发”→“公众号设置”→“功能设置”→“JS接口安全域名”，下载官方txt校验文件，上传到域名根目录，最后在输入框只填纯域名保存，用手机浏览器先访问一次txt地址，确认能直接看到文件内容，再点保存。
Q：js接口安全域名验证文件放在哪里？可以放在子目录吗？
A：必须放在域名根目录，不能放在子目录，正确访问路径为你的域名/MP_verify_开头的文件名.txt，如果文件放在public或static等子目录下，访问路径会多一层目录，校验请求找不到文件，直接失败。
Q：js接口安全域名和业务域名区别是什么？必须同时配置吗？
A：业务域名控制网页能否在微信内置浏览器中访问，JS接口安全域名控制网页能否调用微信JS-SDK能力，两者独立配置，校验文件不能通用，只有需要用自定义分享、扫一扫、图像接口时才需要JS接口安全域名；只需要网页在微信里打开时配置业务域名即可。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/%e5%a6%82%e4%bd%95%e7%94%b3%e8%af%b7js%e6%8e%a5%e5%8f%a3%e5%ae%89%e5%85%a8%e5%9f%9f%e5%90%8d%ef%bc%8c%e9%9c%80%e8%a6%81%e4%bb%80%e4%b9%88%e6%9d%a1%e4%bb%b6%ef%bc%9f/
