InetAddress.getLocalHost()不可靠，因依赖hosts/DNS配置，易返回127.0.0.1或抛UnknownHostException；应改用Runtime.exec("hostname")获取主机名、遍历NetworkInterface过滤回环地址获取真实IPv4。
直接调用 InetAddress.getLocalHost() 会抛出 UnknownHostException
这不是代码写错了，而是系统层面的主机名解析失败。常见于 hosts 文件未正确映射本地主机名（比如 macOS 的 localhost 指向 ::1，而 Java 默认优先尝试 IPv4），或 Linux 下 /etc/hostname 和 /etc/hosts 不一致。
实际操作建议：
- 先确认系统主机名：
hostname（Linux/macOS）或echo %COMPUTERNAME%（Windows） - 检查
/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）中是否包含形如127.0.0.1 myhost的条目，且myhost与hostname输出一致 - 若仅需 IPv4 地址，可绕过主机名解析，改用网络接口枚举（见下节）
用 NetworkInterface 枚举非回环、已启用的 IPv4 地址
当 InetAddress.getLocalHost() 不可靠时，这是最稳妥的替代方案。它不依赖 DNS 或 hosts 配置，直接读取网卡状态。
关键点：
立即学习“Java免费学习笔记（深入）”；
- 过滤条件必须同时满足：
isUp() == true、isLoopback() == false、地址为instanceof Inet4Address - 多个网卡（如 Wi-Fi + 以太网 + Docker 虚拟网卡）可能返回多个结果，通常取第一个非回环 IPv4 即可，但生产环境应按业务需求筛选（例如绑定特定网卡）
- 注意：Docker 容器内运行时，
docker0等虚拟接口也会被列出，需额外排除（如接口名含docker、veth）
示例片段：
Enumeration<NetworkInterface> interfaces = NetworkInterface.getNetworkInterfaces();
while (interfaces.hasMoreElements()) {
NetworkInterface ni = interfaces.nextElement();
if (!ni.isUp() || ni.isLoopback()) continue;
Enumeration<InetAddress> addresses = ni.getInetAddresses();
while (addresses.hasMoreElements()) {
InetAddress addr = addresses.nextElement();
if (addr instanceof Inet4Address && !addr.isAnyLocalAddress() && !addr.isLinkLocalAddress()) {
System.out.println("IP: " + addr.getHostAddress() + ", Hostname: " + addr.getHostName());
break; // 取第一个有效 IPv4
}
}
}
InetAddress.getHostName() 返回的是反向 DNS 名，不是操作系统主机名
很多人误以为 getHostName() 总是返回 hostname 命令输出的内容，其实它查的是 DNS PTR 记录（即 IP → 域名）。如果本地没有配置反向解析，或 DNS 不响应，就可能退化为 IP 字符串本身（如 "192.168.1.100"），甚至触发超时。
真正获取操作系统主机名的方式是：
-
System.getProperty("os.name")不行 —— 这是系统类型 - 正确做法：
System.getProperty("user.name")是当前用户，System.getenv("HOSTNAME")（Linux/macOS）或System.getenv("COMPUTERNAME")（Windows）才是主机名 - 跨平台封装建议：优先读
System.getenv("HOSTNAME")，为空则 fallback 到System.getenv("COMPUTERNAME")
在容器或云环境中，getLocalHost() 很可能返回 127.0.0.1 或异常 IP
Kubernetes Pod、Docker 容器默认网络命名空间里，localhost 解析行为与宿主机不同；很多云平台（如 AWS ECS、阿里云函数计算）也禁用或重定向了本地 DNS 查询。
此时必须放弃“本地主机”这个概念，改用明确方式：
- 从环境变量读取（如 K8s 中的
HOST_IP、POD_IP） - 通过元数据服务获取（如 AWS EC2 的
http://169.254.169.254/latest/meta-data/local-ipv4） - Java 应用启动时由运维注入真实监听地址（如 Spring Boot 的
--server.address=192.168.1.100）
硬编码依赖 InetAddress.getLocalHost() 在这类环境里几乎必然失效。
