CentOS 上排查 RabbitMQ 连接问题的实用流程
一 快速定位思路
- 明确客户端要连的地址与端口：AMQP 通信端口为5672，管理控制台端口为15672。先确认应用配置是否写成了管理端口、是否写错了端口或主机名。
- 先做本机自检，再做跨机连通性测试，最后核对认证与权限。
- 结合错误类型判断方向：
- Connection refused：目标主机可达但端口未监听/被拒绝（服务未起、端口不对、被策略拒绝）。
- Socket timeout/No route to host：网络不通、路由不可达、端口未放行（常见于云主机安全组/本机防火墙未开）。
- ACCESS_REFUSED：用户名/密码错误或vhost不存在/无权限。
- vhost not found / 530：未创建对应vhost或名称写错。
- Hostname mismatch / nodedown：节点主机名解析不一致，常见于修改过主机名但未同步到 /etc/hosts 或 hostname。
二 本机与端口可达性检查
- 服务与端口监听
- 查看服务状态：
systemctl status rabbitmq-server（未运行则 systemctl start rabbitmq-server）。
- 查看端口监听：
ss -lntp | egrep ':(5672|15672|4369|25672)' 或 netstat -ntlp | egrep ':(5672|15672|4369|25672)'。
- 启用管理插件（如未启用）：
rabbitmq-plugins enable rabbitmq_management，管理控制台默认端口15672。
- 本机连通性
telnet 127.0.0.1 5672、curl -I http://127.0.0.1:15672（能连上说明本机监听正常）。
- 防火墙放行（CentOS 7/8 常用 firewalld）
- 放行端口：
firewall-cmd --permanent --add-port=5672/tcp、firewall-cmd --permanent --add-port=15672/tcp
- 使配置生效：
firewall-cmd --reload
- 核对端口：
firewall-cmd --list-ports
- 不建议直接关闭防火墙，优先精确放行端口。
三 跨机连通性与网络路径排查
- 基础连通
ping <服务器IP>（ICMP 可达不代表端口可达）。telnet <服务器IP> 5672 或 nc -vz <服务器IP> 5672（不通多为防火墙/安全组/服务未监听）。
- 云环境与安全组
- 在云控制台核对实例的安全组/NACL是否放行入站 TCP 5672（管理界面还需放行 15672）。
- 错误类型与网络判断
- No route to host：多为网络层不可达（VPC 路由、ACL、物理网络问题）。
- Socket timeout：端口未放行或中间设备（NAT/代理/负载均衡）未转发到目标端口。
- 主机名与 Erlang 分布式端口
- 修改过主机名时，确保
/etc/hosts 与 hostname 一致，避免 epmd/节点通信异常。
- 节点间通信还依赖 4369（epmd） 与 25672（Erlang dist），必要时一并放行。
四 认证 权限与 vhost 核对
- 默认账户限制
- RabbitMQ 3.x 默认账户 guest 仅允许从localhost连接，远程连接请创建新用户。
- 创建与管理员用户：
rabbitmqctl add_user admin StrongPass!、rabbitmqctl set_user_tags admin administrator、rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"。
- vhost 与权限
- 常见报错：ACCESS_REFUSED（用户名/密码错）、530 / vhost not found（vhost 不存在或无权限）。
- 处理：在管理控制台或命令行创建所需 vhost，并为用户授予对应 configure/write/read 权限。
五 日志与常见异常处置
- 查看日志定位根因
- 服务端日志：
/var/log/rabbitmq/rabbit@<hostname>.log、/var/log/rabbitmq/rabbit@<hostname>_erl.log。
- 客户端报错对照日志关键词（如 ACCESS_REFUSED、vhost not found、nodedown）。
- 心跳与中间设备导致的“意外关闭”
- 现象：日志出现
missed heartbeats from client, timeout: 10s 或客户端报 unexpected close。
- 处置：
- 保持合理的心跳（客户端与服务器协商，常用 30–60 秒），不要禁用心跳；
- 在客户端或系统启用合适的 TCP keepalive；
- 检查负载均衡器/代理的空闲超时，确保大于心跳间隔。
- 主机名不一致导致节点无法连接
- 现象：
nodedown、Hostname mismatch。
- 处置：统一并持久化 hostname，在
/etc/hosts 为当前主机名添加 127.0.0.1 映射，重启 RabbitMQ。