微信域名验证失败：使用 Nginx 配置返回验证文件内容

在接入微信公众号网页授权、JS-SDK 或小程序业务域名时，微信要求证明对域名的控制权。最常见的方式是：

请将以下内容保存为 txt 文件，上传至你的服务器 https://yourdomain.com/xxxxxx.txt，确保可公开访问。

但实际场景中常遇到以下问题：

没有 FTP 权限；
前端是 SPA（如 Vue/React），所有路径由前端路由接管，/xxxxxx.txt 返回 HTML 而非纯文本；
使用了 CDN 或对象存储，上传小文件很麻烦；
希望用最轻量、最可靠的方式完成验证。

本文介绍使用 Nginx 一行配置快速部署微信要求的验证文件的方法。

一、为什么微信要验证 .txt 文件？

这是典型的 HTTP-based Domain Ownership Verification（基于 HTTP 的域名所有权验证）机制：

微信服务器会访问 https://yourdomain.com/MP_verify_xxxxxx.txt；
如果返回的内容完全匹配指定字符串（如 abcdefghijklmnopqrstuvwxyz）；
且 Content-Type 为 text/plain；
则认为拥有该域名的控制权。

所以，关键不是'文件'，而是'可公开访问的、返回纯文本的 URL'。

二、解决方案：用 Nginx 直接返回验证内容

无需创建物理文件！利用 Nginx 的 location + return 指令，直接返回指定文本。

Step 1：获取微信提供的验证内容

例如：

文件名：MP_verify_abc123def456.txt
内容：abcdefghijklmnopqrstuvwxyz

Step 2：在 Nginx 配置中添加验证规则

编辑站点配置（如 /etc/nginx/sites-enabled/your-site.conf），在 server 块中加入：

# 微信公众号/小程序域名验证
location = /MP_verify_abc123def456.txt {
    default_type text/plain;
    return 200 "abcdefghijklmnopqrstuvwxyz";
}

说明：

location = /...：精确匹配该 URL，优先级最高；
default_type text/plain：强制返回 Content-Type: text/plain；
return 200 "内容"：直接返回 HTTP 200 和指定字符串，无需磁盘文件。

Step 3：重载 Nginx

nginx -t && nginx -s reload

Step 4：验证是否生效

curl -i https://yourdomain.com/MP_verify_abc123def456.txt

应返回：

HTTP/2 200 content-type: text/plain ... abcdefghijklmnopqrstuvwxyz

完全符合微信要求。

三、其他场景支持

场景 1：需要支持多个验证文件（如公众号 + 小程序）

location = /MP_verify_abc123def456.txt {
    default_type text/plain;
    return 200 "abcdefghijklmnopqrstuvwxyz";
}
location = /MP_verify_xyz789uvw012.txt {
    default_type text/plain;
    return 200 "zyxwvutsrqponmlkjihgfedcba";
}

场景 2：坚持要用物理文件（兼容性考虑）

location ~ ^/MP_verify_[a-zA-Z0-9]+\.txt$ {
    alias /var/www/verify/;
    default_type text/plain;
    expires 1h;
}

然后将 .txt 文件放入 /var/www/verify/ 目录即可。

注意：确保文件权限可读，且 Web 服务器用户（如 www-data）有访问权限。

四、常见错误排查

问题现象	可能原因	解决方案
返回 404	Nginx 未配置该路径	检查 `location` 是否精确匹配
返回 HTML 内容	前端路由拦截了 `.txt` 请求	将 Nginx 规则放在最前面，或使用 `=` 精确匹配
`Content-Type: text/html`	未设置 `default_type`	显式指定 `default_type text/plain;`
微信提示'文件内容不匹配'	多了空格/换行	用 `return 200 "内容";` 避免文件末尾换行

五、为什么这是最佳实践？

零文件管理：无需在服务器上维护任何 .txt 文件；
即时生效：改配置 → 重载 → 完成；
高优先级：location = 精确匹配，不会被前端路由覆盖；
安全：只暴露必要内容，无目录遍历风险；
可复用：未来新增验证，只需复制一行配置。

提示：此方法同样适用于 Google Search Console、Baidu 验证、Apple App Site Association 等类似场景。

六、总结

面对微信的域名验证要求，不要被'上传 txt 文件'字面意思限制。作为运维或开发者，应该用更高效、更可靠的方式解决问题。

通过 Nginx 的 return 指令，不仅完成了验证，还避免了文件管理的麻烦，提升了系统的整洁度和可维护性。

附：一键验证脚本（可加入 CI/CD）

#!/bin/bash
DOMAIN="yourdomain.com"
FILE="MP_verify_abc123def456.txt"
EXPECTED="abcdefghijklmnopqrstuvwxyz"
CONTENT=$(curl -s "https://$DOMAIN/$FILE")
if [ "$CONTENT" = "$EXPECTED" ]; then
    echo "验证通过"
else
    echo "验证失败"
    exit 1
fi

微信域名验证失败：使用 Nginx 配置返回验证文件内容