UnknownHostException 是 DNS 解析失败时抛出的受检异常，发生在域名解析阶段，需在 InetAddress.getByName() 等直接调用处捕获处理，不可依赖全局兜底，应结合诊断与预防策略提升健壮性。
当 Java 应用尝试通过域名（如 www.example.com）建立网络连接时，若 DNS 解析失败（例如域名不存在、DNS 服务器不可达、本地 hosts 配置错误等），JVM 会抛出 java.net.UnknownHostException。这不是运行时异常（RuntimeException），而是受检异常（Exception 的子类），因此必须显式捕获或声明抛出。拦截并合理处理它，是提升服务健壮性和可观测性的关键一步。
明确 UnknownHostException 的触发时机
该异常发生在域名解析阶段，即调用 InetAddress.getByName()、Socket 构造器传入域名、HttpURLConnection 打开连接等操作中——尚未发起 TCP 握手或发送 HTTP 请求。它和连接超时（ConnectException）、读取超时（SocketTimeoutException）有本质区别。
- ✅ 触发：
InetAddress.getByName("invalid-domain-12345.com") - ✅ 触发：
new Socket("fake.api.service", 8080) - ❌ 不触发：
new Socket("google.com", 8080)成功解析后但因防火墙拒绝连接 → 抛ConnectException
在关键网络调用处主动捕获并分类处理
不要依赖全局异常处理器（如 Spring 的 @ControllerAdvice）来兜底——因为很多底层库（如 OkHttp、Apache HttpClient）已将 UnknownHostException 包装为其他异常（如 IOException）。应在你直接控制 DNS 解析逻辑的位置精准捕获。
- 使用
InetAddress前加 try-catch：
try {
InetAddress addr = InetAddress.getByName("api.example.com");
// 继续创建 socket 或构建 URL
} catch (UnknownHostException e) {
log.warn("DNS resolution failed for api.example.com: {}", e.getMessage());
// 可降级到备用域名、IP 或返回友好错误
fallbackToBackupEndpoint();
}
- 对
URL.openConnection()等场景，注意它内部也会调用解析，需捕获其抛出的IOException并检查 cause：
try {
URL url = new URL("https://api.example.com/data");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.connect();
} catch (IOException e) {
if (e.getCause() instanceof UnknownHostException) {
log.error("DNS lookup failed for API endpoint", e);
throw new ServiceException("服务地址不可达，请检查网络配置", e);
}
throw e; // 其他 IO 问题继续上抛
}
增强诊断能力：区分临时性与永久性失败
单纯重试 UnknownHostException 往往无效（除非 DNS 临时抖动）。可通过以下方式辅助判断失败性质：
立即学习“Java免费学习笔记（深入）”；
- 检查异常消息是否含 “nodename nor servname provided”（Unix/Linux）或 “No address associated with hostname”（Windows）→ 多为配置或拼写错误，属永久性失败
-
结合本地 DNS 可达性验证：尝试解析一个高可用域名（如
"1.1.1.1"或"dns.google"）；若也失败，说明本机 DNS 设置异常或网络不通 -
记录原始 hostname 和系统默认 DNS 服务器（通过
NetworkInterface或ManagementFactory.getRuntimeMXBean().getSystemProperties()辅助排查）
预防优于拦截：构建更弹性的域名访问策略
从架构层面降低对 DNS 的强依赖：
- 在配置中同时支持域名与 IP（如
service.host=api.example.com|192.0.2.1），解析失败时自动 fallback 到 IP（需确保 IP 稳定且未启用 SNI 依赖） - 使用服务发现机制（如 Nacos、Eureka、Consul），由客户端缓存健康实例列表，绕过传统 DNS 查找
- 对关键外部依赖，预热阶段主动执行 DNS 解析并缓存
InetAddress（注意 TTL 过期问题，可配合定时刷新） - 在 CI/CD 流水线中加入 DNS 连通性检查（如用
dig或 Java 小脚本），阻断配置错误上线
