RabbitMQ消息队列Ubuntu故障排查指南

一、服务状态检查

首先确认RabbitMQ服务是否正在运行，使用以下命令查看服务状态：

sudo systemctl status rabbitmq-server

若服务未运行，启动服务：

sudo systemctl start rabbitmq-server

若启动失败，需结合日志进一步分析（参考日志分析部分）。

二、日志分析定位问题

RabbitMQ的日志文件位于/var/log/rabbitmq/目录下，文件名为rabbit@<hostname>.log（<hostname>为主机名）。使用以下命令实时查看最新日志：

sudo tail -f /var/log/rabbitmq/rabbit@$(hostname).log

日志中会记录启动失败、连接异常、资源不足等关键错误信息，是故障排查的重要依据。

三、端口与网络连接排查

RabbitMQ默认使用5672（AMQP协议，客户端通信）和15672（HTTP协议，管理界面）端口。若端口被占用或网络不通，会导致连接失败。

1. 检查端口占用

使用以下命令查看端口监听情况：

sudo ss -tulnp | grep -E '5672|15672'

若端口被占用，可通过kill -9 <PID>终止占用进程，或修改RabbitMQ配置文件（/etc/rabbitmq/rabbitmq.conf）中的listeners.tcp.default参数更换端口。

2. 检查网络连通性

在客户端机器上使用ping命令测试与RabbitMQ服务器的网络连接：

ping <RabbitMQ服务器IP>

使用telnet命令测试端口是否可达：

telnet <RabbitMQ服务器IP> 5672

若无法连通，需检查防火墙（Ubuntu默认使用ufw）或云服务器安全组规则，开放对应端口：

sudo ufw allow 5672/tcp  # 开放5672端口
sudo ufw allow 15672/tcp # 开放15672端口
sudo ufw reload          # 重新加载防火墙规则

四、配置文件检查

RabbitMQ的主要配置文件为/etc/rabbitmq/rabbitmq.conf（RabbitMQ 3.7+版本）和/etc/rabbitmq/rabbitmq-env.conf（环境变量配置）。常见配置错误包括：

• 端口号、虚拟主机（vhost）、用户名密码设置错误；
• 配置文件语法错误（如缩进、引号不匹配）。

修改配置文件后，需重启RabbitMQ服务使配置生效：

sudo systemctl restart rabbitmq-server

五、资源使用排查

RabbitMQ对内存、磁盘空间有最低要求，资源不足会导致服务异常。

1. 检查内存使用

使用以下命令查看系统内存使用情况：

free -h

通过RabbitMQ管理命令查看内存使用详情：

sudo rabbitmqctl status | grep -E "mem_used|mem_limit"

若内存使用超过阈值（默认vm_memory_high_watermark为0.4，即40%），需调整阈值或扩容内存：

sudo rabbitmqctl set_vm_memory_high_watermark 0.6  # 调整为60%

2. 检查磁盘空间

使用以下命令查看磁盘空间使用情况：

df -h /var/lib/rabbitmq  # RabbitMQ数据目录

若磁盘空间不足（默认disk_free_limit为50MB），需清理日志、备份文件或扩容磁盘：

sudo rabbitmqctl set_disk_free_limit 2GB  # 调整为2GB

六、连接问题排查

1. 连接超时

若客户端连接RabbitMQ时出现Connection timed out错误，需检查：

• RabbitMQ服务器是否启动；
• 网络是否连通（参考端口与网络连接排查）；
• 防火墙/安全组是否开放端口（参考端口与网络连接排查）；
• 客户端连接参数（主机名、端口、用户名、密码）是否正确。

若主机名修改后未在/etc/hosts文件中解析，需添加映射（如127.0.0.1 <hostname>），并重启RabbitMQ服务。

2. 连接断开

若连接频繁断开，需检查：

• 心跳设置（默认60秒），客户端与服务端心跳需一致；
• 内存或磁盘触发流控（参考资源使用排查）；
• TLS证书是否过期（若使用加密连接）。

七、集群问题排查（若部署集群）

若RabbitMQ以集群模式部署，常见故障为节点无法加入集群，需检查：

• Erlang Cookie文件（/var/lib/rabbitmq/.erlang.cookie）内容是否一致（所有节点需相同）；
• 节点间端口（4369用于Erlang端口映射、25672用于节点间通信）是否开放；
• 主机名是否能正确解析（参考连接问题排查）；
• 节点状态（使用sudo rabbitmqctl cluster_status查看集群状态）。

八、消息积压与消费问题

1. 消息积压

若队列中消息积压严重（messages_ready值持续增长），需检查：

• 消费者处理速度是否过慢；
• 消费者数量是否不足（增加消费者实例）；
• 队列是否设置了最大长度（通过rabbitmqctl set_policy设置队列长度限制）。

2. 消息丢失

若消费者未收到消息，需检查：

• 消息是否持久化（队列声明时durable=true，消息发布时delivery_mode=2）；
• 是否启用了消息确认机制（消费者端auto_ack=false，处理完成后手动ack）；
• 是否配置了死信队列（DLQ），处理过期或拒绝的消息。