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で確認します。
ほかのエラーメッセージを調べる
Connection refusedConnection timed outTemporary failure in name resolutionREMOTE HOST IDENTIFICATION HAS CHANGEDbad interpreter: No such file or directoryArgument list too longToo many open filesRead-only file systemOperation not permittedis not in the sudoers fileKilled(Out of memory)No space left on devicecommand not foundPermission denied (publickey)Device or resource busyText file busyNo such file or directoryJob for xxx.service failed because the control process exited with error codeCould not get lock /var/lib/dpkg/lock-frontendsudo: unable to resolve hostSegmentation fault (core dumped)