localhostで接続が拒否されましたの原因と解決方法

「localhostで接続が拒否されました（ERR_CONNECTION_REFUSED）」は、ブラウザがアクセスしたポート番号で、待ち受けているプログラムが見つからなかったときに表示されるエラーです。つまり、「サーバーが起動していない」か、「サーバーは起動しているが、ブラウザが別の場所（ポート・アドレス）にアクセスしている」かのどちらかです。

このエラーは、原因がいくつも考えられるため、順番に切り分けるのが解決への近道です。この記事では、確認する順番に沿って、よくある原因と確認コマンド、解決方法を解説します。

まず確認：エラーの種類

似たメッセージでも、意味が違います。ブラウザに表示されたエラーコードを確認してください。

「接続が拒否されました」なら、サーバーまでの到達に問題があります。以下の順番で確認します。

原因の切り分け（確認する順番）

1. サーバーが起動していない

最も多い原因です。

• ターミナルを閉じた、パソコンをスリープさせた後に、サーバーが止まっている
• 起動時にエラーが出て、起動に失敗している（ターミナルの最後を見るとエラーが出ている）
• npm run dev などを実行したターミナルと、別のターミナルを見ている

サーバーを起動したターミナルを確認し、「Local: http://localhost:5173/」「Listening on port 3000」のような起動メッセージが表示されているかを確認します。エラーが出ている場合は、そのエラーを先に解決します。

2. ポート番号が違う

開発サーバーのツールによって、既定のポート番号が違います。サーバーの起動メッセージに表示されたURLを、そのまま使うのが確実です。

Viteなどは、既定のポートが使用中だと、自動で別の番号（5174など）で起動します。いつもと同じURLを開くと、つながらないことがあります。

3. そのポートで待ち受けているか確認する

実際に、どのプログラムがどのポートで待ち受けているかを確認します。

# Mac・Linux
lsof -i :3000 -sTCP:LISTEN

:: Windows
netstat -ano | findstr :3000

何も表示されなければ、そのポートで待ち受けているプログラムはありません。サーバーが起動していないか、別のポートで起動しています。

コマンドラインから直接アクセスしてみるのも有効です。

curl -v http://localhost:3000

Connection refused と表示されれば、ブラウザの問題ではなく、サーバー側に原因があることがわかります。curlでは表示されるのにブラウザで表示されない場合は、次の「https」や「ブラウザの設定」を疑います。

4. httpsに自動で切り替わっている

http://localhost:3000 と入力したのに、アドレスバーが https://localhost:3000 に変わっている場合、ブラウザが以前の記録（HSTS）に従って、自動でhttpsに切り替えています。開発サーバーの多くはhttpで動いているため、つながりません。

以前、localhostで別のアプリをhttpsで動かしたことがあると、起きることがあります。

Chromeでの解消方法

1. アドレスバーに chrome://net-internals/#hsts と入力する
2. 「Delete domain security policies」に localhost と入力し、「Delete」を押す
3. ブラウザを再読み込みする

シークレットウィンドウで開いてつながる場合も、ブラウザに残った設定が原因の可能性が高いといえます。

5. IPv4とIPv6の食い違い

localhost という名前は、IPv4の 127.0.0.1 と、IPv6の ::1 のどちらにも対応しています。サーバーが片方だけで待ち受け、ブラウザや別のプログラムがもう片方にアクセスすると、「接続が拒否されました」になります。

確認方法：URLを http://127.0.0.1:3000 に変えて試します。つながる場合は、この食い違いが原因です。

Node.js 17以降では、localhost をどちらのアドレスとして扱うかが、OSの設定の順番に従うように変わったため、開発サーバーとAPIのプロキシ設定の間でこの問題が起きやすくなりました。プロキシの接続先を http://localhost:8080 から http://127.0.0.1:8080 に変える、またはサーバーの待ち受けアドレスを明示すると解決します。

6. Docker・WSL2・仮想環境の中で動いている

Dockerのコンテナで動かしている

コンテナの中のサーバーにアクセスするには、ポートの公開と、アプリが外部からの接続を受け付ける設定の両方が必要です。

docker ps    # PORTS に 0.0.0.0:3000->3000/tcp のように表示されているか

アプリの待ち受けアドレスは、ツールごとに指定します（例：Viteは --host、Flaskは --host=0.0.0.0、Djangoは runserver 0.0.0.0:8000）。

WSL2で動かしている

WSL2（Windows上のLinux）で起動したサーバーは、通常はWindowsのブラウザから localhost でアクセスできます。つながらない場合は、次を確認します。

• サーバーを 0.0.0.0 で待ち受けるように起動する
• WSLを再起動する（PowerShellで wsl --shutdown を実行し、開き直す）
• WSL側のIPアドレス（hostname -I で確認）で直接アクセスしてみる

スマートフォンや別のパソコンからアクセスしている

localhost は「自分自身」を指す名前です。スマートフォンから http://localhost:3000 を開くと、スマートフォン自身にアクセスしてしまいます。別の端末から確認するには、開発しているパソコンのIPアドレス（例：http://192.168.1.10:3000）を使い、サーバーを 0.0.0.0 で待ち受けるように起動します。

7. ファイアウォール・セキュリティソフト

自分のパソコンの中の通信（localhost）がファイアウォールで止められることは多くありませんが、会社のパソコンのセキュリティソフトが、特定のポートやプログラムの通信を制限している場合があります。他の原因に当てはまらない場合は、管理者に確認します。

ツール別：よくある原因

よくある質問

Q. 昨日まで表示できていたのに、急につながらなくなりました。 A. サーバーが止まっている可能性が最も高いです。パソコンの再起動やスリープで、開発サーバーは停止します。起動し直して、起動メッセージのURLを開いてください。

Q. 127.0.0.1とlocalhostは同じですか？ A. 多くの場合は同じ場所を指しますが、localhostはIPv6の ::1 も指すことがあるため、厳密には同じではありません。つながらないときは、127.0.0.1 で試すと原因の切り分けに役立ちます。

Q. 「このサイトにアクセスできません」と表示されます。 A. これはChromeの共通の画面で、その下に表示されているエラーコード（ERR_CONNECTION_REFUSEDなど）で原因が変わります。エラーコードを確認して、この記事の表と照らし合わせてください。

Q. ポート番号を省略して http://localhost だけで開くとどうなりますか？ A. httpなら80番、httpsなら443番に接続します。開発サーバーの多くは3000番や8080番などで動いているため、ポート番号を付ける必要があります。

まとめ

• 「接続が拒否されました」は、そのポートで待ち受けているプログラムがないという意味
• 確認の順番は、起動しているか → ポート番号 → 待ち受けの確認（lsof・netstat）→ https → IPv4/IPv6 → Docker・WSL2
• 起動メッセージのURLをそのまま使う。Viteなどは自動でポートを変えることがある
• アドレスバーが勝手にhttpsになるなら、ChromeのHSTSの設定を削除する
• 127.0.0.1で試してつながるなら、IPv4とIPv6の食い違い
• Docker・WSL2では、ポートの公開と0.0.0.0での待ち受けを確認する

株式会社RJCでは、エラーの原因を一つずつ切り分けて考える力を、エンジニアの大切な基礎だと考えています。こうした知識を仲間と共有しながら、一緒に成長を楽しんでいます。

株式会社RJC ― SI事業・SES事業・AI駆動開発。未経験からエンジニアに育てるのが得意な会社です。