【Laravel】本番だけ500エラーになった原因と解決（Cache＋権限問題）

■ 起こった現象

ステージングでは正常に表示されるが、本番環境だけ500エラーになる

ログを見ると：

production.ERROR: Undefined array key "code"
production.ERROR: Undefined array key "word_url"
production.ERROR: Undefined array key "favorite_prefix"

Bladeで $tile['code'] などが存在しないと怒られている

キャッシュの中身が古いままで、本番環境だけ更新されなかった。

$ttl = app()->isProduction() ? now()->addHours(12) : now()->addSeconds(1);

本番のみ12時間キャッシュが古いまま残る設定にしていた。

問題の箇所：

$table1Sections = Cache::remember("word_table1_sections:{$languageColumn}:{$wordUrlNo}", $ttl, function () {
    // buildWordTiles() の結果をキャッシュ
});

ここでキャッシュされる $tile が古い構造のデータだった。中に入るべき変数が不足してエラーが起こった。

Bladeでエラー回避：

:code="$tile['code'] ?? ''"
:word-url="$tile['word_url'] ?? ''"
:favorite-prefix="$tile['favorite_prefix'] ?? ''"

500エラーは止まるが、根本解決ではない

Cache::remember("v2:word_table1_sections:...", ...)

古いキャッシュを無視できる

キャッシュを削除すればいいだけのことだ、今回キャッシュが削除できずに苦労した。

$ php artisan cache:clear
   ERROR  Failed to clear cache. Make sure you have the appropriate permissions.

グループにapache追加

sudo usermod -aG apache ユーザー名

権限修正

sudo chgrp -R apache storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

setgid設定

sudo find storage bootstrap/cache -type d -exec chmod 2775 {} \;

ACL設定

sudo setfacl -R -m g:apache:rwx storage bootstrap/cache
sudo setfacl -R -d -m g:apache:rwx storage bootstrap/cache

php artisan cache:clear
INFO  Application cache cleared successfully.

復旧。