在 linux 中 nginx 语法检查提示 host not found，通常是因为配置文件中使用了 upstream 或 proxy_pass 指向的域名在当前 dns 环境下无法解析。处理方法是使用 -t 参数运行 nginx -t 命令时，nginx 会尝试解析所有配置的域名，如果系统 dns 配置错误或网络不通，就会报错。可以通过修改 /etc/hosts 文件添加映射，或者修正 /etc/resolv.conf 中的 dns 服务器地址来解决。
Nginx 启动时如何验证配置并定位错误源
要验证 Nginx 配置是否正确并查看具体的错误信息，应执行 nginx -t 命令。该命令会读取 nginx.conf 及其包含的所有配置文件，进行语法检查和资源可用性测试。如果配置中存在无效的域名引用，Nginx 会在输出中明确提示 "host not found" 以及对应的行号。这是排查此类问题的第一步，确保配置文件的语法和逻辑符合预期。
sudo nginx -t # 输出示例： # nginx: [emerg] host not found in upstream "example.com" in /etc/nginx/nginx.conf:10 # nginx: configuration file /etc/nginx/nginx.conf test failed
上述命令执行后，如果看到 "host not found" 错误，说明 Nginx 无法通过当前系统的 DNS 服务解析出指定的主机名。此时需要检查配置文件中引用的域名是否拼写正确，以及系统是否能够正常解析该域名。可以使用 nslookup 或 dig 命令手动测试域名解析情况，确认问题是否出在 DNS 层面。
DNS 解析失败时的常见原因与修复方法
当 nginx -t 报告 "host not found" 时，最常见的原因是系统 DNS 配置不正确或目标域名不存在。修复方法包括检查 /etc/resolv.conf 文件中的 nameserver 设置，确保其指向有效的 DNS 服务器。例如，可以将其设置为公共 DNS 如 8.8.8.8 或 114.114.114.114。此外，如果是在内网环境中，可能需要配置内部 DNS 服务器或在 /etc/hosts 文件中添加静态映射。
# 编辑 resolv.conf 文件 sudo vi /etc/resolv.conf # 添加或修改 nameserver nameserver 8.8.8.8 nameserver 114.114.114.114 # 或者在 hosts 文件中添加静态映射 sudo vi /etc/hosts # 192.168.1.100 example.com
修改 DNS 配置后，再次运行 nginx -t 命令，如果解析成功，错误将消失。需要注意的是，某些情况下 Nginx 可能在启动时才解析域名，因此即使 nginx -t 通过，实际启动时仍可能失败。建议在修改配置后重启 Nginx 服务以应用更改，并使用 systemctl status nginx 检查服务状态。
upstream 块中域名解析失败的特定场景处理
在 Nginx 配置中，如果 upstream 块中定义了域名而非 IP 地址，Nginx 会在启动时解析该域名。如果解析失败，会导致整个 Nginx 进程无法启动。这种情况下，可以将域名替换为 IP 地址，或者确保 DNS 解析在服务启动前可用。对于动态变化的后端服务，建议使用 IP 地址列表或健康检查机制来避免此类问题。
