背景
在 Linux 上安装 RabbitMQ 后，执行启动命令失败：
systemctl start rabbitmq-server
查看 systemd 日志：
journalctl -u rabbitmq-server -xe
日志里大概能看到 hostname 解析失败。因为当时没有保存原始日志，只记得现象类似：主机名是 12.2.3.4 时，RabbitMQ 报找不到 12 的 IP 地址。
后面发现问题不只出现在“主机名刚好是 IP 地址”的情况。只要 hostname 里面包含点号，例如：
12.2.3.4
1.2.3.4-node1
都可能触发同类问题。
原因
RabbitMQ 是基于 Erlang 的。RabbitMQ 节点名默认类似这样：
rabbit@hostname
如果没有显式配置 RABBITMQ_NODENAME，RabbitMQ 启动时会使用当前系统 hostname 生成节点名。官方文档里也明确说了：RabbitMQ 节点名由前缀和 hostname 组成，例如 [email protected]，节点之间和命令行工具都会通过这个节点名通信，所以节点名里的 hostname 必须能被解析。
这里还有一个容易踩坑的点：RabbitMQ 默认使用短节点名（short node name）。短节点名通常只适合 node1 这种不带点号的主机名。如果 hostname 写成 12.2.3.4 或 1.2.3.4-node1，Erlang/RabbitMQ 可能会把点号前面的部分当成短主机名处理，也就是把它理解成 12 或 1，然后去解析这个名字，最终启动失败。
所以这类问题的核心不是“hostname 不能是 IP”，而是：RabbitMQ 默认短节点名不适合带点号的 hostname，尤其不适合把 IP 或类似 IP 的字符串直接拿来当 hostname。
排查
先看当前 hostname：
hostname
hostnamectl
如果输出类似下面这样，就要怀疑这个问题：
12.2.3.4
1.2.3.4-node1
再看 RabbitMQ 的启动日志：
journalctl -u rabbitmq-server -xe
也可以查看更完整的 RabbitMQ 日志目录，具体路径可能和发行版、安装方式有关：
ls -lh /var/log/rabbitmq/
如果日志里出现 hostname 解析失败、节点名解析失败、找不到某个短名字的 IP 地址，就基本能确认方向。
解决办法
最简单的做法是把系统 hostname 改成一个普通主机名，不要使用 IP，也不要包含点号：
hostnamectl set-hostname rabbitmq-node1
检查是否生效：
hostname
hostnamectl
如果 /etc/hosts 里有旧 hostname，也一起改掉。例如单机环境可以这样写：
127.0.0.1 localhost localhost.localdomain
127.0.0.1 rabbitmq-node1
然后重启 RabbitMQ：
systemctl restart rabbitmq-server
systemctl status rabbitmq-server
如果之前启动失败已经留下了旧节点名相关的数据目录，可能还需要根据实际情况清理或迁移 RabbitMQ 数据目录。这个操作会影响已有数据，生产环境不要直接删目录，先确认数据是否可以丢弃。
其他方案
如果你确实需要使用完整域名，可以考虑配置 RabbitMQ 使用 long node name：
RABBITMQ_USE_LONGNAME=true
但这要求节点名里的完整域名能被 DNS 或 /etc/hosts 正确解析。对单机部署来说，直接把 hostname 改成 rabbitmq-node1 这种短名字更简单，也更不容易出错。
总结
RabbitMQ 启动依赖 Erlang 节点名。默认情况下，节点名会使用系统 hostname，并且使用短节点名。
因此安装 RabbitMQ 的机器，hostname 最好使用这种格式：
rabbitmq-node1
mq-node1
node1
不要使用这种格式：
12.2.3.4
1.2.3.4-node1
这次问题最后通过 hostnamectl set-hostname rabbitmq-node1 解决。
参考：