Debian系统RabbitMQ故障排查指南
使用systemctl命令确认RabbitMQ服务是否正在运行。若未运行，尝试启动服务并检查启动状态：
sudo systemctl status rabbitmq-server # 查看服务状态
sudo systemctl start rabbitmq-server # 启动服务
sudo systemctl restart rabbitmq-server # 重启服务（若需重新加载配置）
若服务无法启动，需结合日志进一步分析（参考查看日志文件步骤）。
RabbitMQ的日志默认存储在/var/log/rabbitmq/目录下，文件名通常为rabbit@<主机名>.log。使用以下命令实时查看最新日志，定位错误根源：
sudo tail -f /var/log/rabbitmq/rabbit@$(hostname).log
日志中常见的错误包括配置文件语法错误、端口冲突、Erlang版本不兼容等。
RabbitMQ的主配置文件为/etc/rabbitmq/rabbitmq.conf（部分版本可能使用rabbitmq-env.conf）。检查以下关键配置项是否正确：
listeners.tcp.default = 5672（AMQP默认端口，若被占用需修改）；loopback_users.guest = false（允许本地主机访问guest用户，默认仅localhost可访问）；log.file.level = info（可根据需要调整为debug获取更详细日志）。sudo systemctl restart rabbitmq-server
RabbitMQ依赖多个端口，其中**5672（AMQP）、15672（管理界面）**是最常用的。使用以下命令检查端口是否被占用：
sudo netstat -tuln | grep 5672 # 检查5672端口
sudo lsof -i :15672 # 检查15672端口（若启用了管理插件）
若端口被占用，需停止占用进程或修改RabbitMQ的监听端口（在rabbitmq.conf中调整listeners.tcp.default）。
同时，确保防火墙允许这些端口的流量（以ufw为例）：
sudo ufw allow 5672/tcp # 允许AMQP端口
sudo ufw allow 15672/tcp # 允许管理界面端口
sudo ufw reload # 重新加载防火墙规则
RabbitMQ基于Erlang/OTP开发，版本兼容性至关重要。使用以下命令检查Erlang版本：
erl -version
参考RabbitMQ官方文档（如RabbitMQ 3.11.x需Erlang 25.0及以上），若版本不兼容，需卸载旧版本并安装指定版本（可通过apt或Erlang官方仓库安装）。
默认情况下，RabbitMQ的guest用户仅能从本地主机访问。若需远程访问，需创建新用户并授予权限：
sudo rabbitmqctl add_user admin your_password # 创建用户
sudo rabbitmqctl set_user_tags admin administrator # 设置用户标签（administrator为管理员）
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*" # 授权用户访问默认虚拟主机（/）
同时，检查虚拟主机是否存在（默认虚拟主机为/）：
sudo rabbitmqctl list_vhosts
RabbitMQ的性能受系统资源（内存、磁盘、CPU）限制。使用以下命令监控资源使用情况：
free -m # 查看内存使用（重点关注可用内存）
df -h # 查看磁盘空间（确保根分区有足够空间，建议预留10%以上）
top # 查看CPU使用率（避免CPU过载）
若资源不足，需优化消费者性能（如增加并发）、扩容服务器或调整RabbitMQ的资源限制（如vm_memory_high_watermark设置内存阈值）。
RabbitMQ的功能扩展依赖插件（如管理界面、STOMP协议支持）。使用以下命令查看已启用的插件：
sudo rabbitmq-plugins list
若需要启用管理插件（推荐），执行：
sudo rabbitmq-plugins enable rabbitmq_management
启用后，可通过http://<服务器IP>:15672访问Web管理界面（默认用户名/密码为guest，需提前创建用户）。
/etc/hosts文件，确保主机名解析正确（如127.0.0.1 localhost）；若为端口冲突，修改rabbitmq.conf中的listeners.tcp.default。max-concurrency）、优化消费逻辑（如减少数据库查询时间）或设置消息TTL（过期自动删除）。amqp://localhost:5672）。