遇到nginx域名解析失败，先别急着改nginx配置，多数情况下是DNS解析没生效或缓存了错误结果，按“本地DNS检测 → hosts排查 → nginx配置核对”三步走，最快几分钟就能定位并解决。
nginx域名解析失败最常见的几种现象与原因
现象：访问域名提示502、504或“host not found”
nginx域名解析失败时,用户端通常看到502 Bad Gateway，服务器日志里则出现类似 [error] ... connect() failed (110: Connection timed out) 或 host not found in upstream "api.example.com" 的报错，也有部分场景表现为nginx启动失败，执行nginx -t直接提示“域名解析失败”。
原因：不是只有DNS服务器问题
行业共识认为,80%以上的解析失败来自四个环节：DNS记录本身、服务器本地DNS配置、hosts文件覆盖、nginx配置写法，以下按发生频率排列：
- 域名DNS记录未生效或指向错误IP,例如新购域名忘记添加A记录，或云解析中记录值填成了内网地址。
- 服务器
/etc/resolv.conf中的nameserver不可用，比如内网DNS无法解析公网域名。 - 服务器
/etc/hosts里手动绑定了旧IP，强行覆盖了DNS正确结果。 - nginx配置中
proxy_pass使用域名时，启动阶段解析失败，或解析后缓存了旧IP。 - 防火墙/安全组拦截了nginx到目标服务器的请求，导致看似“解析失败”实际是网络不通。
nginx域名解析失败怎么办？先查DNS还是先查配置
很多人在遇到502时第一时间打开nginx配置文件反复检查,其实效率不高，正确的顺序是：先验证域名在服务器上能不能正确解析，再查nginx配置，因为如果DNS层面已经出错，配置改得再完美也无法恢复正常。
用dig和nslookup定位nginx域名解析失败的具体环节
以一台Linux服务器为例,登录后依次执行以下命令：
nslookup yourdomain.com dig yourdomain.com A
观察返回结果中 Address 值是否指向服务器公网IP，如果解析出来的IP和实际部署nginx的机器IP不一致，说明DNS记录需要修改，如果出现NXDOMAIN，说明域名根本不存在或未添加解析记录。
如果本地没有dig命令，先安装dnsutils：
apt install dnsutils # Debian/Ubuntu yum install bind-utils # CentOS/RHEL
进一步检查实际生效的解析地址：
getent hosts yourdomain.com
这个命令会综合/etc/hosts和DNS返回结果给出最终值，非常直观，若getent显示的是hosts里那行旧IP，直接跳到下一步清理hosts。
检查ngin服务器本地hosts文件和resolv.conf
打开/etc/hosts，看看有没有类似168.1.10 yourdomain.com的条目，部分服务器出于内网访问需要会绑定hosts，当域名解析记录更新后，这些旧条目会成为“定时炸弹”。
再看/etc/resolv.conf：
cat /etc/resolv.conf
确认nameserver这一行，如果指向内网DNS地址（如x.x.x或16.x.x），而这个DNS没有配置公网解析转发，就会出现外网域名全部解析失败的情况，此时将nameserver临时改为5.5.5（阿里公共DNS）或8.8.8测试：
echo "nameserver 223.5.5.5" > /etc/resolv.conf
执行完后再次dig yourdomain.com，若恢复解析，说明原DNS配置有问题。
nginx配置中的域名解析细节与解决方法
确认服务器本身可以正常解析域名后,问题多半集中在nginx配置上。
proxy_pass使用域名时nginx如何解析
nginx在启动或reload时解析proxy_pass中的域名，如果此时DNS不通，直接报host not found in upstream，解析成功后，nginx会缓存结果，即使DNS记录发生变化，也不会立即生效，直到重启或reload。
典型配置场景对比
| 配置写法 | 解析时机 | 适用场景 |
|---|---|---|
proxy_pass http://api.example.com; |
启动/reload时一次性解析 | 域名长期固定，IP几乎不变的场景 |
proxy_pass http://$backend; + resolver 223.5.5.5; |
每次请求动态解析 | 目标域名频繁切换IP，或IP随时可能变更的场景 |
如果proxy_pass后直接写域名，且不配置resolver，nginx默认使用系统resolv.conf，若反馈“nginx域名解析失败”，先检查配置中是否有多余空格或引号，例如proxy_pass http:// yourdomain.com;中间多了空格，会导致解析直接失败。
变更DNS记录后nginx仍然解析到旧IP怎么办
假设域名解析记录已经改到了新服务器IP,但nginx持续转发到旧IP，执行：
nginx -s reload
如果reload无效,则重启nginx：
systemctl restart nginx
重启后验证：
nginx -t curl -I http://yourdomain.com
curl返回的响应头中Server字段及实际页面内容，如果与预期不符，再用curl http://目标IP -H "Host: yourdomain.com"对比测试，可以快速判断是nginx解析错误还是后端服务器响应错误。
让nginx在域名变更后自动重新解析
对于后端服务经常迁移IP的架构,不要在proxy_pass中硬编码域名，改用变量写法：
server {
listen 80;
server_name www.example.com;
resolver 223.5.5.5 valid=30s;
set $backend http://api.example.com;
location / {
proxy_pass $backend;
}
}
关键点有两个：必须定义resolver指定DNS服务器，且用set变量拼接URL，这样nginx会在每个请求时重新解析域名，避免长时间缓存旧IP，需要注意，变量方式下nginx不会自动把$backend解析出的IP写入Host头，需要显式设置：
proxy_set_header Host api.example.com;
否则后端可能收到错误的Host导致返回404。
防火墙、安全组与网络环境导致解析成功但连接失败
有时域名解析完全正常,nginx日志也显示能解析到IP，但请求依然502，这说明问题出在“能解析但连不上”，这种场景容易被误认为nginx域名解析失败，实际是网络层故障。
排查从nginx到目标服务器的连通性
在nginx所在服务器上执行：
ping -c 3 yourdomain.com curl -v http://yourdomain.com
如果curl显示Connection timed out或No route to host，则检查：
- 云服务器安全组是否放行目标端口（如80、8080、443）。
- 目标服务器本地防火墙（
iptables -L、firewall-cmd --list-all）是否允许来自nginx服务器IP的流量。 - 目标服务器是否监听公网IP而不是只监听127.0.0.1。
- 如果目标服务器在另一个VPC或机房,检查路由表和公网IP绑定情况。
另一种常见情况是nginx服务器本身无法访问外网,导致解析公网DNS时超时，可以临时用curl -I http://223.5.5.5
测试出网，不通则需要联系网络管理员。
nginx域名解析失败的快速自检流程
将上述排查步骤整理成以下操作路径,可以大幅缩短故障时间：
- 第一步：
dig yourdomain.com，看解析结果是否指向目标IP。 - 第二步：
cat /etc/hosts，确认无残留旧IP绑定。 - 第三步：
cat /etc/resolv.conf，确保nameserver可用。 - 第四步：
nginx -t，确认配置语法正确且无“host not found”。 - 第五步：
nginx -s reload，让新解析结果生效。 - 第六步：
curl -v http://目标IP -H "Host: yourdomain.com"，测试后端服务是否正常。 - 第七步：检查安全组和防火墙，排除网络拦截。
常见问题解答
nginx域名解析失败和域名解析超时有什么区别？
解析失败是DNS服务器返回了错误结果或者根本没有记录，nginx日志会明确提示host not found。解析超时是DNS服务器没有在限定时间内响应，表现为请求长时间卡住后返回504，前者检查域名解析记录是否正确，后者检查nginx服务器到DNS服务器的网络连通性以及resolver指令的timeout参数设置，nginx的resolver默认超时时间是30秒，网络质量差时可调小到5秒加快失败切换。
nginx域名解析失败会返回502还是404？
通常情况下返回502 Bad Gateway，因为nginx无法将请求转发给上游服务器，直接标识网关错误，如果配置了多个上游且部分不可用，可能出现504，若proxy_pass中的域名解析到IP后，该IP上的路径不存在，则返回404，实际排查时不要只看状态码，应优先查看nginx错误日志（/var/log/nginx/error.log），里面的错误原因比状态码更精确。
修改了DNS记录后，nginx多久能自动使用新IP？
nginx默认只在启动或reload时解析proxy_pass中的域名，所以不重启就不生效，如果需要“改完DNS立即生效”，必须使用带resolver的变量写法，并将valid参数设为较短时间（如valid=10s），此外需要确认服务器本身的DNS缓存不过期，例如systemd-resolved会缓存记录，可执行systemd-resolve --flush-caches清空，实际运维中，建议混合使用：核心上游域名用变量动态解析，非核心域名保持普通写法避免性能损耗。