rabbitmq在centos上的故障排查步驟

1. 檢查RabbitMQ服務狀態

使用systemctl命令確認RabbitMQ服務是否正在運行，若未運行則啟動服務并設置開機自啟：

sudo systemctl status rabbitmq-server  # 查看服務狀態
sudo systemctl start rabbitmq-server   # 啟動服務
sudo systemctl enable rabbitmq-server  # 設置開機自啟

若啟動失敗，可通過journalctl -xe -u rabbitmq-server查看詳細錯誤日志。

2. 查看RabbitMQ日志文件

RabbitMQ的日志默認存儲在/var/log/rabbitmq/目錄下，文件名為rabbit@<hostname>.log（<hostname>為主機名）。使用以下命令查看最新日志，定位錯誤原因：

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

日志中常見錯誤包括配置文件解析失敗、端口沖突、磁盤空間不足等。

3. 驗證端口與網絡連接

RabbitMQ默認使用**5672（AMQP協議）和15672（管理界面）**端口，需確保端口未被占用且網絡可達：

• 檢查端口監聽：

  sudo ss -tulnp | grep -E '5672|15672'  # 查看端口是否被RabbitMQ監聽
  

• 測試網絡連通性：
  在本地機器上使用telnet或nc命令測試與RabbitMQ服務器的端口連接（替換<server_ip>為實際IP）：

  telnet <server_ip> 5672  # 測試AMQP端口
  telnet <server_ip> 15672 # 測試管理界面端口
  

  若無法連接，需檢查防火墻或安全組設置。

4. 檢查配置文件正確性

RabbitMQ的主要配置文件為/etc/rabbitmq/rabbitmq.conf（主配置）和/etc/rabbitmq/rabbitmq-env.conf（環境變量配置），需確保以下關鍵配置無誤：

• rabbitmq.conf：檢查listeners.tcp.default（端口）、vm_memory_high_watermark（內存限制）、disk_free_limit（磁盤空間限制）等參數；
• rabbitmq-env.conf：檢查NODENAME（節點名，需符合rabbit@<hostname>格式）、RABBITMQ_NODE_PORT（端口）等參數。
  配置錯誤會導致服務啟動失敗或功能異常。

5. 確認Erlang環境兼容性

RabbitMQ依賴Erlang/OTP環境，需確保版本兼容（如RabbitMQ 3.12.x需要Erlang 25.3及以上）。檢查Erlang版本：

erl -version

若版本不兼容，需卸載舊版本并安裝指定版本的Erlang（可通過yum或Erlang官方倉庫安裝）。

6. 檢查系統資源使用情況

RabbitMQ對內存、磁盤空間要求較高，需確保資源充足：

• 查看內存使用：

  free -m  # 查看內存剩余量（建議預留1GB以上）
  

• 查看磁盤空間：

  df -h /var/lib/rabbitmq/  # 查看數據目錄所在磁盤的剩余空間（建議預留10GB以上）
  

資源不足會導致RabbitMQ無法啟動或頻繁崩潰。

7. 驗證用戶與權限設置

默認用戶guest僅允許本地訪問（localhost），若需遠程訪問，需創建新用戶并授權：

• 創建用戶：

  sudo rabbitmqctl add_user <username> <password>  # 添加用戶
  

• 設置用戶標簽（權限級別）：

  sudo rabbitmqctl set_user_tags <username> administrator  # 設置為管理員
  

• 授權虛擬主機：

  sudo rabbitmqctl set_permissions -p / <username> ".*" ".*" ".*"  # 授權訪問所有虛擬主機
  

權限不足會導致連接或操作失敗。

8. 啟用管理插件監控狀態

通過管理插件可直觀查看隊列、交換機、連接等狀態，幫助排查問題：

• 啟用管理插件：

  sudo rabbitmq-plugins enable rabbitmq_management
  

• 訪問管理界面：
  在瀏覽器中輸入http://<server_ip>:15672，使用管理員賬號登錄（默認guest/guest僅本地可用）。

9. 檢查防火墻設置

CentOS 7及以上默認使用firewalld管理防火墻，需開放RabbitMQ相關端口：

sudo firewall-cmd --zone=public --add-port=5672/tcp --permanent  # 開放AMQP端口
sudo firewall-cmd --zone=public --add-port=15672/tcp --permanent  # 開放管理界面端口
sudo firewall-cmd --reload  # 重新加載防火墻規則

若使用iptables，需添加對應規則：

sudo iptables -A INPUT -p tcp --dport 5672 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 15672 -j ACCEPT
sudo service iptables save  # 保存規則（CentOS 7及以上可能未安裝）

防火墻攔截會導致外部無法訪問RabbitMQ。