dnsresolutionexception 是第三方库自定义的 dns 解析异常，真实根因需查看其 cause（如 unknownhostexception）；常见原因包括 dns 服务器无响应、域名不存在、防火墙拦截 53 端口等；应检查系统 dns 配置、启用 debug 日志、验证网络连通性，并通过超时设置、重试机制与服务发现优化容错。
Java 中出现 DnsResolutionException，通常意味着程序在尝试解析域名（如通过 InetAddress.getByName() 或 HTTP 客户端发起请求时）无法完成 DNS 查询。但要注意：Java 标准库本身并不定义 DnsResolutionException —— 它是第三方库（如 Netty、OkHttp、Reactor Netty、Micrometer、Spring Cloud LoadBalancer 等）自定义的异常类型，用于封装底层 DNS 解析失败的细节。
确认异常来源和真实根因
该异常本身只是包装器，真正的问题往往藏在它的 cause 中：
- 检查堆栈中
getCause()或嵌套异常（如UnknownHostException、SocketTimeoutException、IOException） - 常见底层原因包括：本地 DNS 服务器无响应、域名不存在（NXDOMAIN）、DNS 返回 SERVFAIL、网络策略拦截 DNS 请求（如防火墙屏蔽 53 端口）、/etc/resolv.conf 配置错误（Linux/macOS）或系统 DNS 设置异常（Windows）
- 若使用 Netty 的
DefaultDnsNameResolver，可启用 DEBUG 日志（io.netty.resolver.dns）查看具体查询过程与超时节点
排查本地 DNS 配置与连通性
Java 进程默认使用操作系统配置的 DNS 服务器（除非显式设置 JVM 参数或代码中指定）：
- 运行
nslookup example.com或dig example.com，验证系统级 DNS 是否正常 - 检查
/etc/resolv.conf（Linux/macOS）或「网络适配器 → IPv4 属性 → DNS 服务器」（Windows），确认 DNS 地址可达且未被污染 - 临时改用公共 DNS 测试，如
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf（Linux）
检查 Java 应用是否绕过系统 DNS
某些框架或客户端会内置 DNS 解析逻辑（如 OkHttp 的 Dns 接口、Netty 的 DnsNameResolver），可能独立于系统配置：
- 若代码中设置了自定义
Dns实现（如 OkHttp 的new OkHttpClient.Builder().dns(...)），需检查该实现是否正确处理异常或缓存失效 - Spring Boot 应用若启用
spring.cloud.loadbalancer.ribbon.enabled=false并使用 Reactor Netty，默认走 Netty DNS；可通过-Dreactor.netty.ioResolver=...调整行为 - JVM 启动参数
-Dsun.net.spi.nameservice.provider.1=dns,sun可强制使用默认 DNS 提供者，避免 JNDI 或其他 SPI 干扰
规避与容错建议
生产环境应减少对 DNS 解析实时性的强依赖：
- 对关键服务地址做静态 IP 映射（如 hosts 文件）或使用服务发现（Consul/Eureka/Nacos），避免频繁解析
- 为 DNS 操作设置合理超时（如 Netty 中
maxQueriesPerResolve(3).timeout(5, TimeUnit.SECONDS)） - 捕获
DnsResolutionException及其 cause，区分可重试（超时、临时不可达）与不可重试（域名不存在）场景，实现退避重试或降级逻辑
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
