環境構築
ERR_CONNECTION_REFUSED
接続が拒否された
こんな症状
ブラウザで「ERR_CONNECTION_REFUSED」と表示されてページが開けない。サーバー接続で起きやすいよ。
まず試す
開発サーバーが起動しているか(npm run dev 等)と、URLのポート番号が正しいかを確認する。
env
# 開発サーバーを起動する
npm run dev
# 表示されたURL・ポート(例 http://localhost:3000)でアクセスするこれで直らなければ、下の「自分のケース」を確認。
🔍 自分のケースはどれ?
- ✓開発サーバーを起動していない
→ npm run dev など起動コマンドを実行する。 - ✓ポート番号が違う
→ サーバーが表示するURL・ポート(localhost:3000 等)でアクセスする。 - ✓起動はしているのに繋がらない
→ サーバーのログにエラーが出ていないか、ファイアウォールがブロックしていないか確認する。
なぜ起きる?
アクセス先のサーバーが起動していない、またはポート番号が間違っているよ。ブラウザは指定されたIPアドレスとポートに接続を試みるけど、そこでサーバーが待ち受けていないと「接続拒否」になるんだ。開発サーバーの起動忘れが最も多い原因だよ。
✕ エラーが起きるコード
$ npm run dev
# サーバーを起動していない状態でブラウザから
# http://localhost:3000 にアクセス
# → このエラーが発生する✓ 直したコード
# ローカル開発なら開発サーバーが起動しているか確認。URLのポート番号が正しいか確認する。✅ 直ったか確認
正しいURL・ポートでページが表示されればOK。
この解決法は役立ちましたか?
🔗 関連するエラー
- Live Serverが起動しない — Live Server 拡張機能が正しく動作していない
- VS Codeの拡張機能が動かない・反映されない — 再起動・有効化・追加設定のどれかが足りていない
- Permission denied (publickey) — SSH鍵が設定されていない
- npm installが失敗する — パッケージのインストールでエラーが出る
- node_modules削除後にエラーが出る — node_modulesを削除したが再インストールしていない
📖 この問題を学べるレッスン
📝 関連ブログ記事
- プログラミングのエラーメッセージの読み方 — エラーの読み方を基礎から解説
- VS Codeのインストール方法 — インストールと初期設定を図解で解説
- プログラミング初心者が最初にやるべきこと5選 — 目的を決めて環境構築から