Что изменилось в 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 выводятся из пути маршрута.
| Поведение | 14 | 15 |
|---|---|---|
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-params | 16.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 — дефолт