getaddrinfo ENOTFOUND：找不到目标主机怎么处理
getaddrinfo ENOTFOUND严重程度 High操作系统的地址查询（getaddrinfo）没有为这个主机名返回任何记录，程序拿不到 IP。最可能是域名不存在、该子域没有配置解析，或本机 hosts/缓存有过期条目；第一步是核对主机名拼写，然后运行 DNS 检测对比三种查询的结果。
结论
getaddrinfo 是程序向操作系统要 IP 的标准接口，ENOTFOUND 是它两手空空回来时的答复。与笼统的"DNS lookup failed"相比，这条报错更具体：查询流程走完了，但结论是"查无此名"。它通常不是网络断了（断网更多表现为超时），而是名字与记录的对应关系出了问题——名字写错了、记录没配、或本机有一份过期的"私货"。
适用环境
- 全部平台（报错原文出自 Node.js 系应用，等价物在 Python 是
gaierror，在 Go 是no such host）
一分钟快速判断
- 逐字符核对主机名：
ENOTFOUND的第一嫌疑永远是拼写。特别注意l/1、o/0、多余空格和结尾的点；从聊天软件复制的地址可能携带不可见字符，手动重敲一遍是最可靠的验证； - 在浏览器里访问同一主机名：浏览器也打不开且提示找不到服务器 → 名字或记录问题；浏览器能打开 → 只有该应用查不到，跳到"本地配置残留"一节；
connproof dns <主机名>看权威解析与系统 lookup 是否给出一致答案。
这条错误代表什么
三种典型场景对应三种证据形态：
- 域名整体不存在：权威解析与系统 lookup 一致返回不存在。域名过期、被注册商暂停，或纯粹写错；
- 子域未配置：主域名能解析而
xxx.主域名不能。服务方换了子域（例如订阅地址从sub.example迁到api.example）而你用的还是旧的； - 本机私货：权威解析正常，系统 lookup 却失败或返回怪异结果——hosts 文件、本地 DNS 缓存或某些"净化"软件改写了系统解析路径。
ConnProof 如何判断
connproof dns 目标主机名报告同时给出 A 记录、AAAA 记录与系统级 lookup 三条证据。判读：
| A/AAAA | 系统 lookup | 结论 |
|---|---|---|
| 都失败（不存在） | 失败 | 名字/记录问题，与本机无关 |
| 成功 | 失败 | 本机解析路径被干扰（hosts、缓存、过滤软件） |
| 失败 | 成功 | hosts 里有手工条目在兜底（值得清理） |
最常见原因
- 拼写或复制错误；
- 域名过期或被暂停：服务方忘续费、被投诉暂停；
- 子域记录未配置或已变更；
- hosts 文件过期条目：早年"改 hosts 上网"的遗产至今仍在大量设备上作祟；
- 本地缓存陈旧：域名刚做过迁移，本机缓存着一条失败的否定应答（negative cache）。
Windows 排查步骤
connproof dns三证据判读；- 指向本机时：
ipconfig /flushdns清缓存；打开C:\Windows\System32\drivers\etc\hosts搜索目标主机名，删除过期条目（需管理员权限）； - 指向名字/记录时：与服务方核对当前正确的主机名——尤其订阅域名，服务方轮换域名后旧域名会集中出现 ENOTFOUND。
macOS / Linux 排查步骤
- 同样三证据判读；
- macOS 清缓存：
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder；Linux 视发行版而定（systemd-resolved：resolvectl flush-caches）； - 检查
/etc/hosts； - Linux 上额外确认
/etc/nsswitch.conf的 hosts 行没有被第三方软件改成怪异顺序。
手机端排查步骤
- 开关飞行模式清一次网络状态；
- 核对客户端里粘贴的地址（手机输入法自动纠错有时会"帮忙"改域名）；
- 换 Wi-Fi/蜂窝对比，排除单一网络的解析劫持。
域名迁移期的"否定缓存"陷阱
有一种情形专门折磨"刚好在服务方迁移域名时在线"的用户：服务方把订阅或接口迁到新子域，新记录在权威 DNS 生效前你查询了一次，得到"不存在"——这个否定应答本身也会被缓存（negative caching，由记录的 SOA 参数决定存活时间，从几分钟到数小时不等）。之后即使记录已经全球生效，你的系统仍在缓存里读到"不存在"，别人都正常就你不行。
识别特征：connproof dns 的权威解析已经能返回地址，而系统 lookup 还在报 ENOTFOUND——与"hosts 兜底"正好相反的组合。处理：按平台清空 DNS 缓存后立即复测；如果走了运营商 DNS 且它也缓存了否定应答，临时换一个 DNS 服务器可以立刻绕开，等原服务器的缓存自然过期后再换回。这类问题会自愈，但知道原理能让你少浪费一下午。
如何区分本地问题和节点问题
| 证据 | 更可能是 |
|---|---|
| 所有设备所有网络都 ENOTFOUND | 域名/记录本身（找服务方） |
| 仅本机失败、他人正常 | 本机 hosts/缓存/过滤软件 |
| 仅当前网络失败 | 该网络的 DNS 劫持或故障 |
| 主域通、子域不通 | 子域记录（服务方配置） |
与超时类解析失败的边界
最后强调一次 ENOTFOUND 与解析超时的区别，因为两者的排查方向相反：ENOTFOUND 是得到了明确的否定回答——查询链路是通的，DNS 系统工作正常，只是它诚实地告诉你"没有这条记录"；超时是没有得到任何回答——查询链路本身出了问题。前者查"名字与记录"，后者查"网络与服务器"。如果你的报错在两者之间摇摆（有时 ENOTFOUND 有时超时），优先按超时处理：不稳定的解析链路在失败边缘会随机产生两种表现，而记录问题的表现是稳定一致的。
仍未解决时收集什么信息
- ConnProof 错误码（DNS-002）与脱敏报告；
- 三条证据（A/AAAA/lookup）的结果组合；
- 多设备、多网络对照结论；
- 操作系统版本与问题开始时间。
禁止提交：完整订阅链接、密码、验证码、私钥、Token。
重新运行检测
connproof dns 目标主机名 --format markdown --output dns-report.md修复后三种查询应返回一致的有效地址。
相关文档
更新记录
- 2026-07-28：规则 v1 发布，确立三证据组合判读表。