冒頭まとめ
Node.jsのサーバーを起動したとき、次のエラーが出ることがあります。
Error: listen EADDRINUSE: address already in use :::3000
これは、指定した待ち受け先が既に使われていて、サーバーを起動できなかったことを表します。Node.jsの公式文書も、別のサーバーが同じ待ち受け先を使用している場合のエラーとして説明しています。
まず、そのポートを使うプログラムを確認します。不要な開発サーバーなら停止し、必要なものなら今回起動するサーバーのポートを変えます。パッケージの入れ直しを始める前に、待ち受け先を確認してください。
:::3000はアドレスとポートをつないだ表示
:::3000 は、IPv6のアドレス :: と、区切りの :、ポート番号 3000 をつないだ表示です。コロンの書き間違いではありません。
公式のlistenの説明では、ホストを省略すると、IPv6が利用可能なら ::、そうでなければIPv4の 0.0.0.0 で待ち受けます。どちらも、特定の1つのアドレスだけに限定しない指定です。
:: での待ち受けがIPv4側も受け付ける環境もあります。エラーがIPv6の表示だからといって、IPv4の待ち受けを確認対象から外さないでください。
また、同じNode.jsのプログラム内で別々のサーバーを作り、同じ待ち受け先を使った場合も重なります。必ずしも別のアプリが原因とは限りません。
Windowsではローカルの待ち受けとPIDを見る
コマンドプロンプトで、現在の接続と待ち受けを表示します。
netstat -a -n -o
Microsoftのnetstatの説明によると、-a は待ち受けを含めて表示し、-n はアドレスとポートを数値で表示し、-o はPIDを表示します。PIDは、実行中のプログラムを識別する番号です。
3000番でエラーが出たなら、TCPの行のローカルアドレスが :3000 で終わり、状態が LISTENING になっている行を探します。外部アドレス側に3000番がある行とは区別してください。
PIDが分かったら、プログラム名を確認します。次の12345は例なので、確認したPIDに置き換えます。
tasklist /fi "PID eq 12345"
tasklistの公式説明には、PIDによる絞り込みが用意されています。ただし、名前が node.exe と分かっても、どのプロジェクトかまでは特定できません。起動したターミナルや、タスクマネージャーの詳細も照合してから停止します。
Linuxでは対象ポートを指定して確認する
Linuxでは、次のコマンドで待ち受け中のTCPの3000番を確認できます。
ss -ltnp 'sport = :3000'
ssの説明書きでは、-l は待ち受け、-t はTCP、-n は数値表示、-p は使用するプロセスの表示です。sport の条件でローカル側のポートを絞ります。
プロセス情報を確認できない場合は、必要な権限で実行してください。表示されたPIDやプログラム名を、停止する対象の確認に使います。
まずは起動したターミナルに戻り、Ctrl+Cで終了させます。自動で起動し直す仕組みを使っている場合は、その管理元で停止してください。子のプロセスだけを止めても、再起動される可能性があります。
既存サーバーを止めるかポートを変える
前に起動した開発サーバーが不要なら、停止した後でもう一度ポートを確認し、今回のサーバーを起動します。
Windowsで起動元から止められない場合は、対象を確認したうえでPIDを指定します。
taskkill /pid 12345
taskkillの説明では、/f は強制終了です。通常の停止で終わらず、強制終了してよい対象だと確認できた場合に限り追加します。
taskkill /pid 12345 /f
既存サーバーも必要なら、今回のポートを変えます。自分で書いたHTTPサーバーなら、次のように指定できます。3001番も空いているとは限らないため、使用状況は確認してください。
// server.cjs
const http = require('node:http');
const server = http.createServer((req, res) => {
res.end('ok');
});
server.listen(3001, '127.0.0.1', () => {
console.log('http://127.0.0.1:3001');
});
この例は自分のPCからの接続に限定しています。開発ツールを使っている場合は、そのツールのポート設定を変更します。PORT 環境変数や --port が有効かどうかはツールによって異なるため、共通の指定として扱わないでください。
エラー処理を追加してもポートは空かない
サーバーの待ち受け失敗は error イベントで通知されます。イベントの公式文書によると、受け取る処理が無いとエラーが投げられ、Node.jsのプロセスが終了します。
次の例では、失敗を表示して終了コードを設定します。使用中のポートを解放したり、サーバーを起動し直したりする処理ではありません。
// server.cjs
const http = require('node:http');
const server = http.createServer((req, res) => res.end('ok'));
server.on('error', (error) => {
console.error(error.code, error.message);
process.exitCode = 1;
});
server.listen(3000);
テストなど、固定ポートが不要な用途では、ポート0を指定してOSに空きポートを選ばせる方法もあります。割り当て結果は待ち受け開始後に読み取ります。
// automatic-port.cjs
const http = require('node:http');
const server = http.createServer((req, res) => res.end('ok'));
server.listen(0, '127.0.0.1', () => {
console.log(`http://127.0.0.1:${server.address().port}`);
});
固定URLを前提にしたブラウザや他のサービスは、割り当てられたポートに合わせる必要があります。
LinuxのNode.js 24.19.0で、最初にOSが選んだポートに別のサーバーを起動すると、listen EADDRINUSE: address already in use :::34029 が出ることを確認しました。番号は実行時の値です。エラーを受け取らない子プロセスは終了コード1となり、既存サーバーを閉じた後は同じポートで起動できました。Windowsの確認・停止コマンドは公式資料との照合のみで、実機では未検証です。
Dockerのポート競合や接続失敗との違い
Dockerのport is already allocatedは、Docker側のポート公開で出るエラーです。Node.jsのログに本件が出ている場合と、Dockerがコンテナを起動する段階で停止している場合を分けて確認します。
connection refusedは接続する側で出るエラーです。本件は待ち受ける側が起動できなかったことを示します。
EADDRINUSE の確認では、エラー内のポート番号と実行環境を揃えてください。コンテナや別のOS環境の中で起動している場合は、エラーを出した環境内の待ち受けも確認対象です。
解決手順のまとめ
エラーに出たポートの待ち受けとPIDを確認し、不要な開発サーバーなら起動元から止めます。止める前に対象を特定し、既存サーバーも必要なら今回のポートを変更します。
:::3000 のコロンを直したり、エラー表示だけを抑えたりしても、待ち受けの重なりは解消しません。停止や設定変更の後に再起動し、実際に接続できるところまで確認してください。
免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。
この記事でエラーは解決しましたか？