この記事の要点

Laravel でよく遭遇するエラーの入口ページ 頻出は 500 系 / Blade コンパイル / DB 接続 / ルーティングの 4 領域 php artisan tinker と storage/logs/laravel.log が最初に見るべき場所 .env 変更後は必ず php artisan config:clear + cache:clear 本番では APP_DEBUG=false — エラー詳細が画面に出ないので必ずログを確認

Laravel エラー対処の起点

このページは、Laravel でよく遭遇するエラーと対処の入口です。エラーメッセージの意味・起きやすい原因・まず確認したい設定やコードのポイントを整理しています。

切り分けの早道

段階	確認するコマンド / ファイル	目的
1	storage/logs/laravel.log の末尾	500 系の本物のスタックトレースを確認
2	.env ファイルの内容	APP_ENV / DB_HOST / APP_KEY が正しいか
3	php artisan config:clear	キャッシュされた古い設定をクリア
4	php artisan cache:clear	アプリケーションキャッシュをクリア
5	php artisan route:list	ルートが期待通り定義されているか
6	php artisan tinker	モデル / 設定値を対話的にテスト
7	composer dump-autoload	クラスロード不能エラー時

500 Internal Server Error

本番で APP_DEBUG=false の場合、画面には「Whoops, looks like something went wrong.」とだけ出ます。詳細はログにあります:

# 最新エラーの確認（tail で監視）
tail -f storage/logs/laravel.log

# 本日のログだけ見る場合
grep "$(date +%Y-%m-%d)" storage/logs/laravel.log | less

# よくある原因:
#  - PHP メモリ不足: php.ini の memory_limit
#  - permission denied: storage/ や bootstrap/cache/ の書き込み権限
#  - .env の APP_KEY 未設定 → php artisan key:generate
#  - DB 接続失敗（次のセクション）

DB 接続エラー

エラー	原因
SQLSTATE[HY000] [2002] Connection refused	DB サーバ未起動 / DB_HOST 違い
SQLSTATE[HY000] [1045] Access denied for user	DB_USERNAME / DB_PASSWORD 違い
SQLSTATE[HY000] [1049] Unknown database	DB_DATABASE の DB が未作成
SQLSTATE[42S02] Base table or view not found	マイグレーション未実行 → php artisan migrate
SQLSTATE[42000] Syntax error	Eloquent クエリの生 SQL に typo

Blade コンパイルエラー

• "Undefined variable: xxx": コントローラから view に変数を渡し忘れ → compact('xxx') または ['xxx' => $xxx]
• "Class 'App\Models\Xxx' not found": モデルの use 文不足、または composer dump-autoload
• "Trying to access array offset on value of type null": $obj->prop->sub で中間が null → $obj?->prop?->sub ?? '' （Null safe operator）
• "@if が閉じていない": @endif 漏れ。Blade コメント {{-- --}} 内に @if が混入していないか
• キャッシュが原因: php artisan view:clear で Blade コンパイル済みファイルをクリア

ルーティングエラー

• "Route [xxx] not defined": route('xxx') で名前未定義 → routes/web.php の ->name('xxx') を確認
• "Method [POST] not allowed": ルートが GET のみ定義されている → Route::post 追加
• "419 Page Expired": CSRF トークン不一致 → form に @csrf、Ajax は X-CSRF-TOKEN ヘッダ
• "404 Not Found" だが URL は合っているはず: php artisan route:cache 後にルートを変更して反映されていない → php artisan route:clear

環境変数 (.env) 関連

• .env 変更後に反映されない: php artisan config:clear 必須
• キャッシュ環境で動作不安定: php artisan config:cache を本番でだけ使う
• "Encryption key (APP_KEY) not specified": php artisan key:generate で生成
• ".env に書いた変数を config() で取れない": config/xxx.php 経由が原則。env() は config 内でだけ使う

キャッシュ系で何かおかしいときの「全部消す」コマンド

php artisan config:clear      # 設定キャッシュ
php artisan cache:clear       # アプリケーションキャッシュ
php artisan view:clear        # Blade コンパイル済み
php artisan route:clear       # ルートキャッシュ
php artisan event:clear       # イベントキャッシュ（Laravel 6+）
composer dump-autoload        # クラスローダ更新

# または artisan optimize の逆操作
php artisan optimize:clear

関連情報

• ログレベル: .env の LOG_LEVEL=debug で詳細ログ出力（本番は error 推奨）
• Telescope: 開発時に laravel/telescope を入れると、リクエスト・クエリ・例外を Web UI で確認できる
• Ignition: デフォルトのエラー画面。スタックトレースと変数値を見ながらデバッグ可能
• Bagisto / Backpack / Filament 等の管理画面パッケージ: 独自のエラーパターンを持つので個別ドキュメントを参照