教員ログインを有効化しても画面に出ない、原因は force-dynamic 書き忘れの静的プリレンダ

結論

認証を経ない公開ページに動的 API の呼び出しが無いと、Next.js はビルド時点の状態でそのルートを静的プリレンダし、CDN が s-maxage で長期キャッシュします。DB の値を後から変えても、force-dynamic を明示しない限り画面には反映されません。

/login は共通ログインを有効化済みの学校が1校以上あるかを DB から引いて教員ログイン UI の出し分けを決める設計でしたが、force-dynamic の指定が無く、ビルド時点（有効校0件）の HTML がそのまま固定配信されていました。

症状

system_admin が学校の共通パスワードを設定し teacher_login_enabled を有効にしても、/login に教員ログイン UI が現れませんでした。DB 側の値は正しく更新されていて、/ops/schools/... の管理画面側の表示にも反映されています。公開側の /login だけが古いままでした。

原因

/login は共通ログインが有効な学校の有無を毎リクエスト DB から引いて教員モードを出し分ける Server Component です。ただし force-dynamic の指定が無かったため、Next.js はこの公開ルートを他の静的ページと同様、ビルド時点の状態で静的プリレンダしました。ビルド実行時点では有効化されている学校が0件だったため、「教員ログインなし」の HTML がそのまま固定され、s-maxage=31536000（1年）の長期キャッシュが付与されました。

本番のレスポンスヘッダーで x-nextjs-prerender:1 とキャッシュの HIT を確認し、静的プリレンダが原因であることを特定しました。

直す

/login に export const dynamic = "force-dynamic" を追加し、毎リクエスト DB を引く動的レンダリングに固定しました。

export const dynamic = "force-dynamic";

あわせて、学校の共通パスワードを設定・解除するアクション（setSchoolTeacherPasswordAction / clearSchoolTeacherPasswordAction）側でも revalidatePath("/login") を呼び、有効化直後の反映を確実にしています。

revalidatePath(`/ops/schools/${schoolId}/edit`);
revalidatePath(`/ops/schools/${schoolId}`);
revalidatePath("/login");

force-dynamic が本体の対策で、revalidatePath は動的化と二重の安全策です。片方だけでは、force-dynamic を将来誤って外した場合や、別の経路で teacher_login_enabled が変わった場合に同じ症状が再発します。

気づけなかった理由

/login の教員ログインの出し分けロジック自体は、コードレビューで見ても「有効な学校があれば UI を出す」という条件として正しく書けています。ローカル開発環境では毎回動的にレンダリングされるため、この分岐がキャッシュに固定されるという事象は再現しません。

本番で CDN のキャッシュを経由して初めて、ビルド時点の HTML が長期間配信され続けるという症状が現れます。ロジックが正しいことと、そのロジックが実行されるタイミングが正しいことは別の確認が要る、という話でした。

同じ Next.js のキャッシュまわりで、ミドルウェアの許可リストが原因だった話は 認証ミドルウェアが robots.txt をログインへリダイレクトする に書いています。