WordPressのローカル環境構築ツール「Local WP」を使っていたら、ある日突然ローカルサイトが開けなくなりました。
ここでは私が実際に遭遇した不具合、試したこと、その結果、最終的に解決した方法を整理します。
備忘録も兼ねているので、同じように困っている方の参考になれば幸いです。
発生した不具合
Localを起動してサイトをStartすると、以下のどちらかのエラーメッセージが表示されるようになりました。
missing mailpit v1.12. Don't worry. We'll reinstall it next time you start your site.（Mailpit v1.12が見つかりません。ご心配いりません。次回サイトを起動する際に再インストールいたします。）Heads-up! Local's router is having trouble starting.（お知らせ：ローカル環境のルーターの起動に問題が発生しています。）
結果として、ローカルサイトがブラウザで開けない状態に。
試したことと結果
1. 再起動や stop→start
→ 効果なし。エラーメッセージは出続ける。
2. Local の再インストール
→ 変化なし。同じエラーが出る。
3. ダウングレード
→ 一時的に mailpit のエラーは消えたが、Local's router is having trouble starting が残って解決せず。
4. ドメイン設定（.local → .test など）
/etc/hosts を確認して、127.0.0.1 に正しく向いていることも確認。
ping でも応答は返ってきたので DNS レベルは問題なし。
→ 依然として Router が起動しない。
5. Routerログの確認
~/Library/Application Support/Local/run/router/logs/ に出力されるエラーログを見ると、
unknown directive "http2" in /.../server-block-ssl.conf
というエラーが大量に出ていた。
つまり Nginx が「http2」という記述を理解できずに落ちていた。
問題の原因
- Local の 最新版 では、Nginx の設定ファイルに
listen 443 ssl; listen [::]:443 ssl; http2 on;という「新しい書き方」が自動で生成される。 - ところが、環境に残っていた 古い Nginx（lightning-services） はこの書き方を理解できないため、
unknown directive "http2"エラーを出して Router が落ちていた。
つまり、Local本体は新しいのに、内部で使う Nginx が古いまま残っていたことが原因。
最終的な解決方法
以下の手順で、Local 内部の Nginx を強制的に入れ替えたところ解決しました。
- Local を完全終了
Quit してアイコンが消えるまで終了。 - 問題のあるフォルダを削除（ターミナル例）
rm -rf ~/Library/Application\ Support/Local/run/router rm -rf ~/Library/Application\ Support/Local/lightning-services/nginx-* rm -rf ~/Library/Application\ Support/Local/lightning-services/mailpit-* - Local を再起動してサイトを Start
→ Local が自動的に最新版の Nginx と Mailpit をダウンロードし直す。 - SSL の再生成
サイトを右クリック → SSL → Regenerate → Trust を実行。
これで Router のエラーが消え、ローカルサイトを開けるようになりました。
補足
/etc/hostsの設定自体は問題なしでした。
なので DNS 解決ではなく、Nginx の世代違いが根本原因。- Norton や macOS ファイアウォールがダウンロードやポート割り当てを邪魔することもあるので、再生成がうまくいかない場合は一時的に無効化すると良いです。
- 同じ症状が出たら「Local の Nginx（lightning-services）を消して再取得させる」と覚えておくと手っ取り早いです。
まとめ
- 発生したエラー：
Heads-up! Local's router is having trouble starting - 原因：Local 本体と内部 Nginx のバージョン不一致
- 解決方法：
routerとnginx-*を削除 → Local に再ダウンロードさせる
結果、無事にローカルサイトを再び開けるようになりました。
👉 Local WP を使っていて突然「Router が起動しない」となった方は、
再インストールよりも lightning-services のクリーンアップをまず試すのがおすすめです。
コメントを残す