UnresolvedAddressException 表明异步连接前主机名未解析为IP，需提前异步解析地址而非捕获该异常；推荐用CompletableFuture包装InetAddress.getAllByName或使用Vert.x/Netty等框架内置异步DNS解析。
UnresolvedAddressException 是 Java NIO 中一个明确的信号：你传给异步通道（如 AsynchronousSocketChannel）的地址尚未解析为有效的 IP 地址，比如用了主机名但 DNS 查询还没完成或失败了。它**不是网络超时或连接拒绝**，而是发生在连接发起前的“参数校验阶段”。正确处理它，关键在于**别让它发生——提前解析地址**。
明确触发时机：地址未解析就调用 connect()
当你直接用 InetSocketAddress.createUnresolved(host, port) 或传入含主机名的字符串构造地址，并立刻调用 channel.connect(address) 时，JVM 无法在不阻塞的前提下完成 DNS 解析（异步通道不负责同步解析），就会立即抛出 UnresolvedAddressException。
常见错误写法：
channel.connect(new InetSocketAddress("example.com", 80));channel.connect(InetSocketAddress.createUnresolved("api.service", 443));
推荐做法：异步解析地址再连接
把 DNS 解析本身也做成异步操作，避免阻塞线程，同时让错误有明确归属。
- 使用
java.net.InetAddress.getByName(host)是同步的，会阻塞，不推荐用于高并发异步场景 - 更合适的是借助
java.net.InetAddress.getAllByName(host)配合CompletableFuture包装成异步任务，或使用 Netty、Vert.x 等框架内置的异步 DNS 解析器 - 解析成功后，用返回的
InetAddress构造已解析的InetSocketAddress，再调用connect()
示例逻辑（简化）：
CompletableFuture<InetSocketAddress> resolve(String host, int port) {return CompletableFuture.supplyAsync(() -> {
InetAddress addr = InetAddress.getByName(host);
return new InetSocketAddress(addr, port);
});
}
异常捕获只是兜底，不是主流程
虽然你可以 try-catch UnresolvedAddressException 并降级处理（如记录日志、返回错误响应），但这属于防御性编程，不能替代前置解析。
- 捕获它说明设计上已有疏漏——本该解析却没做
- 真实环境中，DNS 失败、主机名拼错、防火墙拦截等都会导致解析失败，这些应统一在解析阶段暴露和重试
- 连接阶段的异常（如
IOException、TimeoutException）才代表网络通路问题，和地址解析是两个层次
框架层面更省心的方案
如果你用的是 Vert.x 或 Netty：
- Vert.x 的
WebClient默认走异步 DNS，自动处理解析失败并回调onFailure - Netty 的
DefaultDnsNameResolver支持缓存、超时、多服务器查询，配合Bootstrap.connect()时完全隐藏解析细节 - 这些框架把 UnresolvedAddressException 拦截在底层，对外暴露的是语义更清晰的错误类型（如
DnsResolveTimeoutException）
