java.net.UnknownHostException 解决方法

原文链接：https://blog.csdn.net/qq_39390545/article/details/108755289
以下为复盘学习笔记

---

UnknownHostException 一般原因

UnknownHostException 是Java编程中常见的一个网络异常，通常在试图通过域名查找并连接到一个主机时抛出。这个异常的主要原因有以下几点：

第1步: 排查本地hosts文件配置： 在某些情况下，操作系统会先查看本地的hosts文件来解析域名。
如果hosts文件中没有对特定域名的映射，或者映射的IP地址不正确，也会导致此异常。

第2步: 排查DNS解析： 执行DNS解析过程时，如果DNS服务器无法找到与该域名对应的IP地址，则会抛出此异常。可能是由于：
2.1、域名拼写错误或格式不正确。
2.2、 网络问题导致DNS查询请求无法到达DNS服务器。
例如防火墙阻止了DNS查询请求，或者网络连接完全断开。
2.3、DNS服务器本身的问题，如宕机、配置错误或缓存过期等。
DNS更改传播到全球所有DNS服务器需要时间，新注册的域名或最近修改的DNS记录可能在短时间内不能被所有地方正确解析。

---

[Q&A] 如何在本地hosts文件配置域名和IP？

在开发环境中，有时可以暂时直接在本地hosts文件中添加域名和IP地址的对应关系以快速测试功能。在服务器发送求时，就会 自动把域名转成IP 进行调用了。

以CSDN的域名为例（www.csdn.net）

第1步：用有互联网的机器 win+r → cmd 进入dos窗口

第2步：执行 nslookup www.csdn.net 命令，获取www.csdn.net域名对应的IP，

C:\Users\zhang>nslookup www.csdn.net
服务器:  public1.114dns.com
Address:  114.114.114.114

非权威应答:
名称:    55cb88f4.csdn.net.cname.yunduns.com
Address:  123.129.227.28
Aliases:  www.csdn.net

第3步：打开hosts文件
Windows：一般在C:\Windows\System32\drivers\etc\hosts
Linux：一般在/etc/hosts

第4步：修改hosts文件，把域名和IP写到hosts文件中，用于把域名解析成IP

第5步：执行 ipconfig/flushdns 清除DNS缓存

第6步：完成，这样就可以调到CSDN域名下的接口了。如https://www.csdn.net/xxx/login

常见抛此异常场景

网络请求：

发起HTTP/HTTPS请求时，如果DNS无法解析目标域名的IP地址，则会抛出此异常。

   URL url = new URL("http://unresolved-domain.com");
   HttpURLConnection conn = (HttpURLConnection) url.openConnection();
   // 此处可能会抛出UnknownHostException

数据库连接：

在JDBC中，如果你提供的数据库URL是一个域名而非IP地址，并且该域名无法被DNS解析，则会抛出此异常。

   String url = "jdbc:mysql://unresolved-db-server:3306/mydatabase";
   Connection conn = DriverManager.getConnection(url, "username", "password");
   // 此处可能会抛出UnknownHostException

Socket通信：

在直接使用Socket进行TCP/IP通信时，如果需要通过域名创建Socket连接，而域名未解析成功，则会抛出此异常。

   try {
       InetAddress address = InetAddress.getByName("unresolved-domain.com");
   } catch (UnknownHostException e) {
       System.out.println("Failed to resolve the host.");
   }

服务发现与调用：

在微服务架构中，客户端可能依赖于服务注册中心（如Eureka、Consul）获取其他服务的地址，如果获取到的地址是未解析成功的域名，后续进行远程服务调用时也会遇到这个问题。