Summary

Next.js 15.1 は React 19 の正式サポート、デバッグ体験とソースマップの改善、after() の安定化、および認可エラー用の実験的 API (forbidden/unauthorized) などを含むアップデートです。開発者向けに移行手順と運用上の注意点を簡潔にまとめます。

Key Points

• React 19
  • Pages Router で React 19 を正式サポート。App Router は Canary 経由で最新の React Canary 機能を継続サポート。
• デバッグ／ソースマップ改善
  • source map の ignoreList を活用して外部依存のフレームを折りたたみ、ブラウザとターミナルで一貫したスタック表示を実現。
  • Turbopack が安定化しており、より正確なメソッド名検出とプロファイリングが可能。
• after()（安定化）
  • レスポンスの送信後にログや解析などの副次タスクを非同期実行する API。自己ホスト環境や runtime API（cookies/headers）との連携改善を含む。
• forbidden()/unauthorized()（実験）
  • App Router 内で 403 / 401 をトリガーし、app/forbidden.tsx / app/unauthorized.tsx でカスタム UI を提供可能。
  • 実験機能の有効化例（next.config.ts）:

// next.config.ts
/** experimental.authInterrupts を有効化 */
const nextConfig = {
  experimental: { authInterrupts: true },
}
export default nextConfig

• 注意: レスポンスヘッダ送信後にエラーを発生させた場合、ステータスコードが 200 になる挙動があります。

Upgrade

• 自動アップグレード: npx @next/codemod@canary upgrade latest
• 手動アップグレード: npm install next@latest react@latest react-dom@latest
• 新規開始: npx create-next-app@latest

Practical notes

• ライブラリ作者は sourcemap に ignoreList を設定すると、利用者のデバッグが容易になります。
• 実験 API を本番運用する前に挙動（ステータス、ヘッダ送信タイミング）を検証してください。

Other changes（抜粋）

• create-next-app が ESLint 9 を採用、キャッシュタグ上限を 128 に増加、CSS 関連の実験的改善や多数のバグ修正。