批量修改主机名后 Java 应用抛 UnknownHostException 的排查与处置
记录时间：2026-08-11
环境：生产虚拟机集群，CentOS 6.5 / CentOS 7.9 混合
一、问题现象
对一批 hostname 仍为 localhost 的虚拟机批量改名（命名规则 host<IP第三段>_<IP第四段>，下称 hostNN_NN），执行完成后，部分机器上的 Java 应用开始报错：
java.net.UnknownHostException: hostNN_NN
Local host name unknown
javax.jms.JMSException: could not connect to broker URL: tcp://<broker_ip>:61616.
消息队列（ActiveMQ）消息转发失败，且不是单台，多台已改名机器陆续出现。
二、排查过程
2.1 先看异常名，判断是”谁”解析失败
异常文本里出现的名字是 hostNN_NN（本机刚改的新主机名），而不是 broker 地址。这个细节很关键：解析失败的是本机自己，不是远端 broker，直接排除了 broker 故障。
2.2 检查本机 hostname 与解析
hostname
getent hosts "$(hostname)"
改名脚本当时只执行了 hostnamectl set-hostname（CentOS 7）或改 /etc/sysconfig/network（CentOS 6），没有同步 /etc/hosts，所以 getent hosts hostNN_NN 查不到任何条目。
2.3 确认解析链路
grep '^hosts:' /etc/nsswitch.conf
# 结果：hosts: files dns myhostname
标准链路先查 /etc/hosts（files），没有再查 DNS。当时 /etc/hosts 没有映射、DNS 也没有记录，解析必然失败。
三、根因分析
3.1 核心结论
改了 hostname 却没同步 /etc/hosts。Java 应用（ActiveMQ 客户端等）创建连接时会调 InetAddress.getLocalHost()，内部通过 gethostbyname 把本机 hostname 解析成 IP，解析不到就抛 UnknownHostException。
3.2 CentOS 6 与 CentOS 7 的 hostname 机制
两个版本对 hostname 的管理方式不同，但共同点是都不负责解析：
- CentOS 7+：
hostnamectl set-hostname只写/etc/hostname和内核 hostname，不会动/etc/hosts - CentOS 6.5：
/etc/sysconfig/network里的HOSTNAME=负责定义主机名，同样不把主机名解析成 IP
/etc/sysconfig/network（或 /etc/hostname） → 定义 hostname
/etc/hosts → hostname ↔ IP 映射
/etc/resolv.conf → DNS 服务器
3.3 为什么改名后才爆发
改名后 hostname 从 localhost.localdomain 变成 hostNN_NN，而 /etc/hosts 里只有 localhost 系列、DNS 也没有新名字，这个新名字两边都查不到。之前应用能跑，是因为旧名还能解析。
四、解决方案
4.1 应急止损：批量补 /etc/hosts
对已改名机器幂等补映射（追加到 127.0.0.1 行，已有则跳过），并 getent 验证：
# 核心逻辑（fix-hosts-for-hostname.yml）
- shell: |
hn="{{ cur_hostname.stdout }}"
if ! grep -qE "([[:space:]]|^)${hn}([[:space:]]|$)" /etc/hosts; then
sed -i "/^127\.0\.0\.1[[:space:]]/s/$/ ${hn}/" /etc/hosts
fi
when: cur_hostname.stdout is match("^host[0-9]+_[0-9]+$")
# 先单台验证，再批量
ansible-playbook -i hosts/xxx fix-hosts-for-hostname.yml -l <一台IP>
ansible-playbook -i hosts/xxx fix-hosts-for-hostname.yml -f 10 --limit @limit文件
补完重启应用（或触发重连），消息转发恢复。
4.2 根治：改名时同步 /etc/hosts
把 /etc/hosts 同步逻辑直接并入改名 playbook，后续改名不再产生该故障：
# set-hostname.yml 改名后追加
if ! grep -qE "([[:space:]]|^)${target_hostname}([[:space:]]|$)" /etc/hosts; then
sed -i "/^127\.0\.0\.1[[:space:]]/s/$/ ${target_hostname}/" /etc/hosts
fi
4.3 手工核对命令
hostname
getent hosts "$(hostname)" # 有输出 = 解析成功
grep '^hosts:' /etc/nsswitch.conf
cat /etc/hosts
五、验证
- 批量执行后
getent hosts $(hostname)全部有输出（返回127.0.0.1或本机接口 IPv6 地址），不再抛UnknownHostException - 重启 Java 应用后消息转发恢复
- 全量复查确认除个别特殊机器外均正常
六、注意事项 / 常见问题
改 hostname 属生产高风险操作，本环境近期已多次出现同一根因，建议把”同步 /etc/hosts”作为改名的标准步骤。
- hostnamectl 不会自动改 /etc/hosts，CentOS 7+ 同样要手动补映射
- 受影响的不仅是 ActiveMQ：Tomcat、JMX、监控 agent 等任何依赖
getLocalHost()的 Java 组件都会踩 /etc/hosts里若已有业务映射行（如127.0.0.1 dockerhub.xxx.com），用sed批量追加时会污染这些行（给它们也加上 hostname 别名）。批量操作应只匹配127.0.0.1的 localhost 行- 部分机器解析结果优先返回
fe80::（IPv6 链路本地）而非127.0.0.1：只要解析成功（不抛错）Java 应用即正常，不必纠结显示来源 - 个别机器需要单独处理：hostname 被某服务反复重置为 localhost、hostname 命名格式异常等
七、参考资料
- man 5 hosts / man nsswitch.conf（/etc/hosts 与解析顺序）
- Java InetAddress.getLocalHost()：https://docs.oracle.com/javase/8/docs/api/java/net/InetAddress.html
- systemd nss-myhostname：https://www.freedesktop.org/software/systemd/man/latest/nss-myhostname.html