Node.jsでEADDRINUSEが出る原因と直し方
Node.js で開発サーバーを起動したときに EADDRINUSE: address already in use と出て止まるのは、使おうとしたポートを、別のプログラムがすでに使っているためです。そのプログラムを見つけて止めるか、別のポートで起動すれば、エラーは消えます。
私は検証環境でこのエラーをわざと起こし、ターミナルに出たメッセージと、ポートを空けたあとに起動できることを確かめました。ターミナルで node server.js や npm run dev を実行したら、ポートが使用中と言われて起動できない、という場面の話です。Vite の開発サーバーでは、同じ原因でも出るメッセージが違うので、あとの節で分けて説明します。
検証環境は Ubuntu 24.04、Node.js 22.23.4、npm 10.9.9、Vite 8.3.8 です。ポートを調べるコマンドは ss(iproute2 6.1.0)と lsof 4.95.0 を使いました。この環境では IPv6 が使えません。Windows と macOS、Docker のコンテナの中で動かす場合は試していません。
同じポートでサーバーを2つ起動すると出るメッセージ
検証には、ポート 3000 で待ち受けるだけのサーバーを使いました。
import { createServer } from 'node:http';
const server = createServer((req, res) => {
res.end('hello\n');
});
server.listen(3000, () => {
console.log('http://localhost:3000 で待ち受けています');
});
1つ目の node server.js を動かしたまま、2つ目を起動すると、次のように出て終了しました(終了コードは 1。パスは例示用の値に置き換えています)。
node:events:497
throw er; // Unhandled 'error' event
^
Error: listen EADDRINUSE: address already in use 0.0.0.0:3000
at Server.setupListenHandle [as _listen2] (node:net:1941:16)
at listenInCluster (node:net:1998:12)
at Server.listen (node:net:2103:7)
at file:///path/to/app/server.js:7:8
at ModuleJob.run (node:internal/modules/esm/module_job:343:25)
at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:681:26)
at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5)
Emitted 'error' event on Server instance at:
at emitErrorNT (node:net:1977:8)
at process.processTicksAndRejections (node:internal/process/task_queues:89:21) {
code: 'EADDRINUSE',
errno: -98,
syscall: 'listen',
address: '0.0.0.0',
port: 3000
}
Node.js v22.23.4
listen EADDRINUSE は、待ち受け(listen)を始めようとしたところ、そのアドレスとポートが使用中だった、という意味です。Node.js のエラーの一覧でも、EADDRINUSE は、サーバーをローカルのアドレスに結びつけようとして、同じマシンの別のサーバーがそのアドレスを使っていたために失敗したもの、と説明されています。
メッセージの末尾にある 0.0.0.0:3000 は、使おうとしたアドレスとポートです。listen() にホストを渡さないと、Node.js は IPv6 が使えるなら ::、使えなければ 0.0.0.0 で待ち受けます(server.listen() で port と host を渡す形の説明)。検証環境は IPv6 が使えないので 0.0.0.0 と出ました。どちらが出ても、見るべきなのは最後のポート番号です。
ポートを使っているプログラムを調べる
止めるべき相手は、エラーの最後に出たポートを使っているプログラムです。Linux では ss で調べられます。-l は待ち受け中のもの、-t は TCP、-n はポートを番号のまま、-p は使っているプロセスを出すオプションです(ss のマニュアル)。
$ ss -ltnp 'sport = :3000'
State Recv-Q Send-Q Local Address:Port Peer Address:PortProcess
LISTEN 0 511 0.0.0.0:3000 0.0.0.0:* users:(("node",pid=2548,fd=21))
pid=2548 が、ポート 3000 を使っているプロセスの番号です。lsof でも同じことが分かります。
$ lsof -i :3000
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
node 2548 root 21u IPv4 8465 0t0 TCP *:3000 (LISTEN)
どちらの出力でも、分かるのはプログラムの名前が node であることまでです。止める前に、どのファイルを動かしている node なのかを確かめておくと、別の作業で動かしているサーバーを止めてしまわずに済みます。lsof -t はプロセスの番号だけを出すので(lsof のマニュアル)、ps に渡すと、起動したときのコマンドが分かります。
$ lsof -t -i :3000 | xargs ps -o pid,args -p
PID COMMAND
2548 node server.js
1つ目に起動した node server.js が、まだ動いていたことが分かりました。
見つけたプログラムを止めると、エラーが消える
調べたプロセスの番号を kill に渡して、そのサーバーを止めます。
$ kill $(lsof -t -i :3000); sleep 1; lsof -i :3000
止めたあとの lsof -i :3000 は何も出さず、ポート 3000 を使っているプログラムがなくなりました。この状態でもう一度 node server.js を実行すると、エラーは出ずに次のように表示され、curl -s http://localhost:3000/ には hello が返りました。
http://localhost:3000 で待ち受けています
fuser -k 3000/tcp でも、ポート 3000 を使っているプロセスを探して止められます。検証環境では、いま起動し直したサーバー(2573)が止まり、そのあとの lsof -i :3000 は何も出しませんでした。
$ fuser -k 3000/tcp; sleep 1; lsof -i :3000
3000/tcp: 2573
ただし、fuser のマニュアルにあるとおり、-k が送るのは SIGKILL です。kill がシグナルを指定しないときに送る SIGTERM と違い、SIGKILL はプログラムの側で受け取って処理することができません(signal のマニュアル)。終わる前の後片付けをさせたいなら、kill のほうを使います。
別のポートで起動する
動いているほうのサーバーを止めたくないときは、新しく起動するほうのポートを変えます。次のコードでは、ポート番号を環境変数 PORT から受け取り、EADDRINUSE のときは短い案内を出して終わるようにしました。server.listen() の説明にある EADDRINUSE の扱い方のとおり、このエラーはサーバーの error イベントで受け取れます。
import { createServer } from 'node:http';
const port = Number(process.env.PORT ?? 3000);
const server = createServer((req, res) => {
res.end('hello\n');
});
server.on('error', (err) => {
if (err.code === 'EADDRINUSE') {
console.error(`ポート ${port} は、ほかのプログラムが使っています。`);
console.error(`止めるか、PORT=${port + 1} node server-handled.js のように別のポートで起動してください。`);
process.exit(1);
}
throw err;
});
server.listen(port, () => {
console.log(`http://localhost:${port} で待ち受けています`);
});
ポート 3000 で node server.js を動かしたまま、これを起動すると、長いスタックの代わりに案内だけが出て終了しました(終了コードは 1)。
$ node server-handled.js
ポート 3000 は、ほかのプログラムが使っています。
止めるか、PORT=3001 node server-handled.js のように別のポートで起動してください。
案内どおり PORT=3001 node server-handled.js で起動すると、次のように表示され、curl -s http://localhost:3001/ にも hello が返りました。
http://localhost:3001 で待ち受けています
Vite の開発サーバーでは、メッセージが違う
Vite の開発サーバー(npm run dev で動く vite)は、設定を変えなければ、このエラーでは止まりません。1つ目の vite を動かしたまま、2つ目を起動すると、次のように隣のポートに移って起動しました。
Port 5173 is in use, trying another one...
VITE v8.3.8 ready in 195 ms
➜ Local: http://localhost:5174/
➜ Network: use --host to expose
Vite の server.port の説明にあるとおり、ポートが使われていると、空いている次のポートを自動で試します。このとき、ポート 5173 では、先に起動していたほうのサーバーが動いたままです(ss -ltnp 'sport = :5173' で確かめました)。新しく起動したほうを開くには、表示された Local: の URL(ここでは http://localhost:5174/)を使います。ポート 5173 を使っていたのが Vite ではなく Node.js のサーバーでも、同じように 5174 に移りました。
ポートを移らずに止まってほしいときは、--strictPort を付けます(server.strictPort の説明と、CLI のオプションの一覧)。付けて起動すると、EADDRINUSE の文字は出ず、次のメッセージで終了しました(終了コードは 1。パスは例示用の値に置き換えています)。
error when starting dev server:
Error: Port 5173 is already in use
at httpServerStart (file:///path/to/app/node_modules/vite/dist/node/chunks/node.js:14673:10)
at process.processTicksAndRejections (node:internal/process/task_queues:103:5)
at async startServer (file:///path/to/app/node_modules/vite/dist/node/chunks/node.js:25081:30)
at async Object.listen (file:///path/to/app/node_modules/vite/dist/node/chunks/node.js:24887:4)
at async CAC.<anonymous> (file:///path/to/app/node_modules/vite/dist/node/cli.js:734:3)
Vite 8.3.8 のコードを見ると、--strictPort のときにポートを使おうとして EADDRINUSE が返ると、Port 5173 is already in use というメッセージのエラーに置き換えて投げています。原因は Node.js のときと同じなので、直し方も同じです。
ポート 5173 を Node.js のサーバー(PORT=5173 node server-handled.js)が使っているときも、--strictPort を付けると同じエラーで終了しました。この Node.js のサーバーを fuser -k 5173/tcp で止めてから、もう一度 npx vite --strictPort を実行すると、5173 で起動しました。
VITE v8.3.8 ready in 176 ms
➜ Local: http://localhost:5173/
➜ Network: use --host to expose
いつも同じポートで動かしたいなら、vite.config.ts に書いておけます。
import { defineConfig } from 'vite';
export default defineConfig({
server: {
port: 5173,
strictPort: true,
},
});
この設定で、ポート 5173 を別の vite が使っているときに npx vite を実行すると、--strictPort を付けたときと同じ Error: Port 5173 is already in use で終了しました。その場だけ別のポートで動かすなら、npx vite --port 5180 のように --port で指定します。検証環境では、この設定のままでも 5180 で起動しました。





