InetAddress.getHostAddress() 返回的IP类型取决于实际解析结果:DNS返回AAAA记录则为IPv6(如"2001:db8::1"),返回A记录则为IPv4(如"192.168.1.1"),不自动降级或转换。

getHostAddress() 返回的是 IPv4 还是 IPv6?
InetAddress.getHostAddress() 返回的是字符串形式的 IP 地址,具体是 IPv4 还是 IPv6 取决于该 InetAddress 实例实际解析出的地址类型。它不会自动降级或转换:如果 DNS 返回了 AAAA 记录(IPv6),就返回类似 "2001:db8::1" 的字符串;如果只返回 A 记录(IPv4),就返回类似 "192.168.1.1" 的字符串。
常见误区是认为它“默认返回 IPv4”,其实 JDK 会按系统配置和 DNS 响应优先级决定——例如 Linux 上若 /etc/gai.conf 启用了 IPv6 优先,且域名有 AAAA 记录,getByName("example.com") 就很可能返回 IPv6 地址。
- 可通过
addr instanceof Inet4Address或addr instanceof Inet6Address显式判断类型 - 若需强制获取 IPv4,可用
InetAddress.getAllByName(host)遍历结果并筛选Inet4Address实例 - 注意:某些内网环境 DNS 返回 IPv6 地址但本地未启用 IPv6 协议栈,会导致后续 socket 连接失败
getByName() 抛出 UnknownHostException 的真实原因
InetAddress.getByName(String host) 抛出 UnknownHostException 并不只代表“域名不存在”。它是一个笼统的异常,底层可能由多种网络或配置问题触发:
- DNS 解析超时(如本地 DNS 服务器无响应,而非域名本身无效)
- hosts 文件中存在错误条目(如
127.0.0.1 invalid-host但该主机名未运行服务) - Java 启动参数禁用了 IPv6(
-Djava.net.preferIPv4Stack=true)却尝试解析纯 IPv6 域名 - Android 上因 SELinux 策略或网络权限缺失导致 getaddrinfo() 系统调用被拦截
调试时建议先用 nslookup 或 dig 手动验证 DNS 是否可达,再检查 Java 进程是否在相同网络命名空间下(容器/Docker 中尤其容易忽略)。
立即学习“Java免费学习笔记(深入)”;
localhost 解析为什么有时返回 127.0.0.1,有时是 ::1?
调用 InetAddress.getByName("localhost") 的结果取决于 JVM 启动时的网络栈偏好设置和操作系统 hosts 文件内容。JDK 默认行为是:
- 若
/etc/hosts(Linux/macOS)或C:\Windows\System32\drivers\etc\hosts(Windows)中localhost同时映射了 IPv4 和 IPv6(如127.0.0.1 localhost和::1 localhost),则返回第一个匹配项(顺序敏感) - 若仅定义了其中一种,就返回对应类型
- 若设置了
-Djava.net.preferIPv4Stack=true,即使 hosts 里 IPv6 在前,也会优先选127.0.0.1
这个行为在单元测试中容易引发非预期失败——比如测试代码假设 getByName("localhost").getHostAddress() 总是 "127.0.0.1",但在 CI 环境中因 hosts 文件差异或 JVM 参数不同而拿到 "::1",导致字符串比较失败。
getLocalHost() 获取不到本机外网 IP 的根本原因
InetAddress.getLocalHost() 返回的是本机 hostname 对应的首个非回环地址,但它**永远不会返回公网 IP**。原因很直接:hostname 通常只绑定到本地网络接口(如 eth0 的 192.168.x.x 或 10.x.x.x),而 NAT 网关之外的公网 IP 是由 ISP 分配、不在本机路由表中的。
- 该方法本质调用的是系统
gethostbyname(gethostname()),查的是本地 DNS 或 hosts,不是网卡实时 IP - 多网卡机器上结果不可控(可能返回 docker0、vboxnet、wlan0 中任意一个的地址)
- 若 hostname 解析失败(如 /etc/hosts 缺失对应条目),会抛出
UnknownHostException,而非退回到127.0.0.1
真要获取“对外可见”的 IP,必须通过外部服务(如 http://ifconfig.me)发起 HTTP 请求,或者读取特定网卡的配置(需明确指定 interface 名称并过滤掉虚拟接口)。getLocalHost() 的唯一可靠用途,是获取本机在局域网内的可通信地址,且前提是你的 hosts 或 DNS 配置正确。










