Address already in useの原因と対処法|ポートを使用中のプロセスを調べる

Address already in useは、「待ち受けようとしたポートを、別のプロセスがすでに使っている」ことを意味します。sudo ss -tlnp | grep :ポート番号で使用中のプロセスを特定し、不要なプロセスなら停止し、必要なプロセスなら、どちらかのポート番号を変更します。

このエラーが表示される例

nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use)
Error: listen EADDRINUSE: address already in use :::3000

「Address already in use」の意味

サーバーのプログラムは、起動するときに、特定のIPアドレスとポート番号の組み合わせを確保して、接続を待ち受けます。1つの組み合わせを使えるのは、原則として1つのプロセスだけです。すでに別のプロセスが確保していると、あとから起動したプログラムは確保に失敗し、このエラーを出して終了します。

よくある状況は、同じサービスの二重起動、別のソフトウェアとのポートの重複(ApacheとnginxがどちらもTCPの80番を使う、など)、前のプロセスが残っている、の3つです。まず、誰がそのポートを使っているのかを確認します。

原因を切り分ける手順

ステップ1:ポートを使っているプロセスを特定する

$ sudo ss -tlnp | grep ':80 '

右端のusers:(("nginx",pid=1234,fd=6))の部分に、プロセス名とPIDが表示されます。sudoを付けないと、ほかのユーザーのプロセスの情報が表示されません。

ステップ2:そのプロセスの詳細を確認する

$ ps -p 1234 -o pid,ppid,user,etime,cmd
$ systemctl status 1234

いつから動いているのか、どのコマンドで起動されたのかを確認します。systemctl status PIDを実行すると、そのプロセスが、どのサービスに属しているかが分かります。

ステップ3:起動しようとしたサービスの設定を確認する

$ sudo nginx -T | grep listen
$ sudo grep -r Listen /etc/httpd/ /etc/apache2/ 2>/dev/null

待ち受けるポートが、意図したとおりの設定になっているかを確認します。設定の重複で、同じポートを2回確保しようとしている場合もあります。

原因別の対処法

同じサービスが、すでに動いている

すでに起動しているサービスを、手動でもう一度起動しようとしている状態です。設定を反映したいだけなら、sudo systemctl reload サービス名、またはrestartを使います。

別のソフトウェアが、同じポートを使っている

不要なほうを、sudo systemctl stop サービス名で停止し、sudo systemctl disable サービス名で自動起動も止めます。両方とも必要な場合は、片方の待ち受けポートを、設定ファイルで変更します。

古いプロセスが、残っている

サービスとしては停止しているのに、プロセスだけが残っている場合は、kill PIDで終了を要求します。数秒待っても終了しないときに限り、kill -9 PIDを使います。

停止した直後で、ポートがまだ解放されていない

プロセスを止めた直後は、短い時間、同じポートを確保できないことがあります。数十秒待ってから、もう一度起動します。自分で開発しているプログラムであれば、SO_REUSEADDRの指定で回避できます。

注意:
ポートを使っているプロセスを、確認せずにkill -9で止めるのは危険です。
そのプロセスが、本番で稼働中のサービスである可能性があります。
必ずpsやsystemctl statusで、何のプロセスかを確かめてから対処しましょう。

再発を防ぐために

1台のサーバーで複数のサービスを動かす場合は、どのサービスが、どのポートを使うかを、一覧にして管理します。使わないサービスは、systemctl disableで自動起動を止めておくと、再起動後の競合を防げます。サービスの起動と停止は、プログラムを直接実行するのではなく、systemctlに統一すると、二重起動が起こりにくくなります。

よくある質問

EADDRINUSEと表示されます。同じ意味ですか?

同じ意味です。EADDRINUSEは、このエラーの内部的な名前で、Node.jsなどのプログラムは、この名前で表示します。

ssで調べても、使用中のプロセスが見つかりません

sudoを付けているかを確認します。それでも見つからない場合は、UDPのポート(ss -ulnp)や、コンテナがポートを確保している可能性を調べます。

Dockerで「port is already allocated」と表示されます

同じ原因です。ホスト側のポートを、別のコンテナやプロセスが使用しています。docker psとss -tlnpで確認します。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。

ほかのエラーメッセージを調べる

← エラーメッセージ辞典へ戻る