re:re:actable
Урок 076 минут чтения

Что изменилось в Next.js 15 и 16: гид по версиям

На этой странице
Кратко

На собеседовании и при чтении чужого кода важно понимать, какой версии соответствует пример. Next.js 15 (октябрь 2024): React 19, асинхронные params, searchParams, cookies(), headers(), draftMode(); fetch и GET-route handlers больше не кэшируются по умолчанию; клиентский Router Cache по умолчанию не хранит страницы (staleTime 0); next/form, after(), instrumentation.ts, Turbopack для dev. Next.js 16 (октябрь 2025): Turbopack по умолчанию для dev и build, Cache Components (cacheComponents, "use cache", cacheLife, cacheTag) вместо старого PPR, новые API updateTag и refresh, revalidateTag(tag, profile), middleware.ts → proxy.ts, удалены next lint и AMP, поддержка React Compiler, React 19.2. Дальше: 16.1 — кэш Turbopack на диске и анализатор бандла, 16.2 — Adapter API, 16.3 — Instant Navigations, Partial Prefetching, catchError, retry в error.tsx, root params (next/root-params), 16.4 — Cache Components рекомендованы всем и включены в новых проектах, ensureStatic, navigation()/prefetch() из next/cache, React 19.3. В Next.js 17 Cache Components и Partial Prefetching станут поведением по умолчанию.

Вопрос

Чем отличаются Next.js 14, 15 и 16? Какие изменения ломают код при обновлении и какие новые возможности нужно знать?

Главные смены парадигмы

Next 13–14:  App Router + неявное кэширование «везде» (fetch кэшировался по умолчанию)
Next 15:     «ничего не кэшируем без спроса» + асинхронные request API
Next 16:     явный кэш на уровне компонентов ("use cache"), Turbopack по умолчанию
Next 16.3+:  Instant Navigations: статическая оболочка маршрута + частичный prefetch
Next 17:     Cache Components — модель по умолчанию

Next.js 15: что ломает код

// 14: синхронно
export default function Page({ params }: { params: { slug: string } }) {
  return <h1>{params.slug}</h1>;
}
 
// 15+: params и searchParams — Promise
export default async function Page({ params }: { params: Promise<{ slug: string }> }) {
  const { slug } = await params;
  return <h1>{slug}</h1>;
}
 
// Клиентский компонент читает Promise через use()
'use client';
import { use } from 'react';
export function Slug({ params }: { params: Promise<{ slug: string }> }) {
  const { slug } = use(params);
  return <span>{slug}</span>;
}
// 15+: request API асинхронные
const cookieStore = await cookies();
const token = cookieStore.get('session')?.value;
const ua = (await headers()).get('user-agent');

С Next 15.5 есть глобальные хелперы типов PageProps<'/blog/[slug]'> и LayoutProps<'/blog'> — типы params выводятся из пути маршрута.

Поведение1415
fetch(url)Кэшируется (force-cache)Не кэшируется
GET Route HandlerСтатический по умолчаниюДинамический
Router Cache для страниц30 с / 5 мин0 (layout и loading всё ещё переиспользуются)
params, cookies(), headers()СинхронныеPromise

Обновление: npx @next/codemod@canary upgrade latest — codemod-ы переписывают большую часть синтаксиса.

Next.js 16: что ломает код

ИзменениеЧто делать
Turbopack по умолчаниюСвой webpack-конфиг → next build --webpack или перенести на Turbopack
middleware.ts → proxy.ts, функция proxyПереименовать (codemod); Proxy работает в Node.js runtime
revalidateTag(tag)Добавить профиль: revalidateTag(tag, 'max'); для «прочитать свою запись» — updateTag(tag)
experimental.ppr, dynamicIOЗаменены на cacheComponents: true
next lint удалёнЗапускать ESLint напрямую
next/image: priority устарелpreload; дефолтный qualities: [75], локальные картинки с query требуют localPatterns
Параллельные маршрутыКаждому слоту нужен default.tsx
AMP, serverRuntimeConfig, publicRuntimeConfigУдалены; вместо них переменные окружения
Минимум Node.js 20.9, TypeScript 5.1Обновить окружение

Новые API Next 16

'use server';
import { updateTag, refresh, revalidateTag } from 'next/cache';
 
export async function renameProject(id: string, name: string) {
  await db.project.update({ where: { id }, data: { name } });
  updateTag(`project-${id}`); // пользователь сразу видит своё изменение
}
 
export async function markAsRead() {
  await db.notifications.markRead();
  refresh(); // обновить некэшированные данные текущей страницы (счётчик уведомлений)
}
 
export async function onCmsWebhook(tag: string) {
  revalidateTag(tag, 'max'); // фоново: отдаём старое, пока готовится новое
}

16.3–16.4: Instant Navigations

// next.config.ts — модель, которая станет дефолтом в Next 17
const nextConfig: NextConfig = {
  cacheComponents: true,
  partialPrefetching: true,
  reactCompiler: true,
};
  • Partial Prefetching: <Link> загружает заранее общую App Shell маршрута (статику и закэшированное), одну на все ссылки к этому маршруту; prefetch={true} дополнительно подтягивает закэшированный контент, зависящий от URL.
  • ensureStatic (16.4): export const ensureStatic = 'navigation' — сборка упадёт, если в маршрут попадёт динамический компонент.
  • navigation() и prefetch() из next/cache (16.4): await navigation() в компоненте исключает его из prefetch — дорогие части грузятся только при реальном переходе.
  • catchError (16.3): свои границы ошибок, которые не мешают notFound()/redirect() и умеют retry() серверных компонентов.
  • Root params (16.3): import { lang } from 'next/root-params' — параметр корневого сегмента ([lang]) из любого серверного компонента без прокидывания props.
  • DevTools: Instant Insights (подсвечивает медленные переходы), Navigation Inspector, хелпер instant() для Playwright.

Как определить версию примера

Признак в кодеВерсия
getServerSideProps, pages/Pages Router (любая)
params.slug без await в App Router≤ 14
await params, await cookies()15+
middleware.ts≤ 15
proxy.ts, updateTag, "use cache"16+
partialPrefetching, catchError, next/root-params16.3+
ensureStatic, navigation()16.4+

Что важно помнить

  • Советы из статей 2023 года про «кэширование fetch по умолчанию» устарели.
  • Обновляться лучше по шагам и с codemod-ами (npx @next/codemod@canary upgrade latest); в 16.4 появился next upgrade --agent для обновления с помощью AI-агента.
  • Регулярно следи за security-релизами: в 2025–2026 годах выходили критичные исправления протокола RSC — обновления патч-версий обязательны.

Мини-шпаргалка

15: React 19, async params/cookies/headers, fetch не кэшируется, after(), next/form
16: Turbopack, Cache Components, proxy.ts, updateTag/refresh, revalidateTag(tag, profile), без next lint
16.3: Partial Prefetching, catchError, retry, root params, instant() тесты
16.4: Cache Components по умолчанию в create-next-app, ensureStatic, navigation()/prefetch()
17: Cache Components + Partial Prefetching — дефолт

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам