【解決】 RabbitMQ: connection refused の解決方法と原因 | RabbitMQ トラブルシューティング

1. RabbitMQ: connection refused とは？（概要と緊急度）

「RabbitMQ: connection refused」エラーは、RabbitMQサーバーへの接続が拒否されたことを示します。これは、Webサイトへのアクセスが拒否されたり、アプリケーションが正しく動作しなくなったりする可能性があり、通常は中〜高の緊急度を持つトラブルです。

しかし、ご安心ください。このエラーは非常に一般的で、多くの場合、シンプルな手順で解決できます。主に、RabbitMQサービスが稼働していないか、またはネットワーク（特にファイアウォール）によって接続がブロックされていることが原因です。これから、最も速く解決できる方法から順にご説明します。

2. 【最速】今すぐ試すべき解決策

まず、以下の手順でRabbitMQへの接続を試みてください。多くの場合、これで問題は解決します。

解決策1：RabbitMQサービスが実行されているか確認し、起動する

最も一般的な原因は、RabbitMQサービス自体が停止していることです。以下のPowerShellコマンドを使って、サービスの状況を確認し、必要であれば起動してください。

手順：

1. 管理者権限でPowerShellを起動します。（スタートメニューで「PowerShell」と検索し、右クリックして「管理者として実行」を選択します。）
2. 以下のコマンドを入力し、RabbitMQサービスの現在の状態を確認します。

Get-Service RabbitMQ

Statusが「Running」であればサービスは起動しています。「Stopped」の場合は、以下のコマンドでサービスを起動します。

Start-Service RabbitMQ

サービスが正常に起動したら、再度アプリケーションからの接続を試みてください。これだけで問題が解決することが非常に多いです。

解決策2：Windows Defender Firewallでポート5672がブロックされていないか確認する

RabbitMQはデフォルトでポート5672を使用します。このポートがファイアウォールによってブロックされていると、「connection refused」エラーが発生します。

手順：

1. 管理者権限でPowerShellを起動します。（解決策1と同様）
2. 以下のコマンドで、ポート5672を許可する受信ルールが存在するか確認します。

Get-NetFirewallRule -Direction Inbound -LocalPort 5672 | Format-Table -AutoSize

もしポート5672を許可するルールが見つからない、または既存のルールがブロックしている場合は、以下のコマンドで新しいルールを追加してポート5672を許可します。

New-NetFirewallRule -DisplayName "RabbitMQ_5672_Inbound" -Direction Inbound -LocalPort 5672 -Protocol TCP -Action Allow -Profile Any -EdgeTraversalPolicy Allow

または、GUIで確認したい場合は以下の手順で開くことができます。

1. 「スタート」メニューから「Windows Defender Firewall」を検索して開きます。
2. 左側のメニューから「Windows Defender Firewallを介したアプリまたは機能を許可」をクリックします。
3. 「設定の変更」をクリックし、リストの中から「RabbitMQ」または「Erlang OTP」に関連する項目（あれば）を確認し、チェックが入っているか確認します。
4. 左側のメニューから「詳細設定」をクリックし、「受信の規則」でポート5672がブロックされていないか確認します。必要に応じて新しい受信規則を作成し、TCPポート5672を許可します。

ファイアウォール設定を変更したら、再度接続を試みてください。

3. RabbitMQ: connection refused が発生する主要な原因（複数）

上記で解決しない場合や、将来的な再発を防ぐために、エラーの主な原因を理解しておきましょう。

• RabbitMQサービスが停止している：最も一般的な原因です。何らかの理由でサービスが停止していると、接続を受け付けられません。
• ファイアウォールによるポートブロック：Windows Defender Firewallやその他のセキュリティソフトウェアが、RabbitMQが使用するデフォルトポート（5672/TCP）への接続をブロックしている可能性があります。
• RabbitMQが正しくインストールされていない、または設定ミス：RabbitMQのインストールが破損しているか、rabbitmq.confなどの設定ファイルに誤りがあり、正しく起動できない場合があります。
• ネットワーク接続の問題：クライアントとサーバー間のネットワーク経路に問題がある、IPアドレスやホスト名が間違っている、DNS解決に失敗しているなどの可能性があります。
• リソース不足：サーバーのメモリやCPUが不足している場合、RabbitMQサービスが正常に起動できないことがあります。

4. RabbitMQで恒久的に再発を防ぐには

一度解決しても、同じ問題が再発するのを防ぐために、以下の対策を検討してください。

• RabbitMQサービスの自動起動設定：システムの起動時にRabbitMQサービスが自動的に起動するように設定されていることを確認してください。通常、インストール時に自動設定されますが、念のため「サービス」管理ツール（services.msc）でスタートアップの種類が「自動」になっているか確認しましょう。
• ファイアウォールルールの永続化：ポート5672を許可するファイアウォールルールが永続的に設定されていることを確認し、意図しない変更が行われないように管理します。上記のPowerShellコマンドで追加したルールは永続化されます。
• 十分なシステムリソースの確保：RabbitMQはメモリを比較的多めに使用することがあります。サーバーに十分なRAMとCPUリソースが確保されていることを確認し、必要であれば増強を検討してください。
• RabbitMQログの定期的な確認：RabbitMQは詳細なログを出力します。デフォルトではC:\Users\...\AppData\Roaming\RabbitMQ\log (Windowsの場合) などにあるログファイルを定期的に確認し、異常がないか監視する習慣をつけましょう。これにより、問題が深刻化する前に兆候を掴むことができます。
• ネットワーク設定の確認と固定化：クライアントとサーバー間のネットワーク設定（IPアドレス、サブネットマスク、ゲートウェイなど）が正しく構成されていることを定期的に確認します。可能であれば、RabbitMQサーバーのIPアドレスを固定（静的IP）にすることをお勧めします。

これらの対策を講じることで、「RabbitMQ: connection refused」エラーの再発リスクを大幅に低減し、安定した運用を維持できるでしょう。