💡 核心理念：Next.js 15+ 标志着框架从“魔法化自动缓存”转向了“显式控制与标准化”。现在的默认原则是：数据默认动态 (Dynamic by default)，需要缓存时手动声明；API 默认异步 (Async by default)，为未来的 I/O 优化铺路。

1. 官方文档

• 文档 (Docs): Next.js Documentation
• 源码 (GitHub): vercel/next.js
• 更新日志 (Changelog): Next.js Releases & Vercel Changelog
• React 官方文档 (React 19): React.dev

2. 新旧版本更新

缓存策略：

• Next.js 14 (及以前):
  • 原则: "Aggressive Caching" (激进缓存)。
  • 行为: fetch 请求默认被缓存 (force-cache)，GET 路由默认是静态的。
  • 痛点: 经常因为不知道哪里被缓存了导致数据不更新，需要到处写 revalidate: 0。
• Next.js 15+ (现状):

  • 原则: "Uncached by Default" (默认不缓存)。

  • 行为: fetch 请求默认是 no-store (动态)，GET 路由处理函数如果没有特殊配置，默认视为动态渲染。

  • 操作: 只有当你明确知道这个数据需要缓存时，才添加配置。

  • 代码对比:

    // Next.js 14 (默认缓存)
    fetch('<https://api.com/data>');
    
    // Next.js 15 (默认不缓存，需手动开启)
    fetch('<https://api.com/data>', { cache: 'force-cache' });
    // 或者使用新的 'use cache' 指令 (React 19/Next 16)
    
    

API 差异：全面异步化 (Async Request APIs)

• 背景: 为了让服务器能在等待请求头/参数的同时并行处理其他逻辑，Next.js 15 将所有依赖请求运行时信息的 API 变成了异步 Promise。
• 影响范围: params (动态路由参数), searchParams (查询参数), cookies(), headers()。
• 破坏性更新 (Breaking Change):

  • 旧写法 (同步):

    // ❌ 在 Next.js 15+ 会报错或报警告
    const { slug } = params;
    const cookieStore = cookies();
    const token = cookieStore.get('token');
    
    

  • 新写法 (异步 - 必须 await):

    // ✅ 正确写法
    const { slug } = await params;
    const cookieStore = await cookies();
    const token = cookieStore.get('token');
    
    

3. React 19 核心概念 (Core Concepts)

Next.js 15 是建立在 React 19 之上的，以下三个概念是开发的基石：

(1) Server Actions (现在的官方名称是 Server Functions)

• 定义: 允许客户端组件通过 <form action={fn}> 或事件处理函数调用在服务端运行的异步函数。
• 革命性: 不需要单独写 /api/... 接口了。数据库逻辑直接写在组件旁边（或单独文件中），像调用本地函数一样调用后端逻辑。