Обновился с Next.js 14 до 15 — сломалось половина проекта, как правильно мигрировать?

[gitgrid7993]

Решил обновиться на Next.js 15 и React 19, запустил npm install next@latest react@latest react-dom@latest — и началось. Во-первых, куча peer dependency warnings от половины пакетов. Во-вторых, useFormState везде подчёркивается как deprecated, надо менять на useActionState. В-третьих, Ant Design 5.x начал выбрасывать предупреждения про ref. Это всё решаемо или лучше подождать пока экосистема устаканится? Проект коммерческий, дедлайн через месяц.

[kirill_backend]

Мигрировал три проекта на Next.js 15 за последние полгода. Вот конкретный порядок действий который у меня работает: 1) сначала обновляй только Next.js, держи React 18, убедись что всё стабильно. 2) Потом отдельно поднимай React до 19. 3) useFormState → useActionState это буквальный find & replace, API почти идентичный, только появился дополнительный pending state. 4) Для Ant Design — в их issues есть официальный workaround, они выкатили патч в 5.21+. Проверь свою версию. 5) --legacy-peer-deps используй только временно, потом чини зависимости нормально.

[aicrypto3317]

Есть ещё одна засада которую не все знают: в Next.js 15 cookies() и headers() теперь асинхронные. Если в коде есть const cookieStore = cookies() без await — сломается в runtime. Прогони grep -r 'cookies()\|headers()\|params\.' . --include='*.ts' --include='*.tsx' по проекту и найди все места. У нас было около 30 файлов где надо было добавить await.

[milana_dns25]

@cloud77, По поводу 'подождать' — не советую. Во-первых, в React 19.0.0-19.2.0 была критическая уязвимость в Server Components (CVSS 10.0, RCE), патч вышел в 19.2.1 и свежих минорных Next.js. Если у вас прод на старых версиях React 19 — это проблема безопасности. Во-вторых, Next.js 16 уже на горизонте, и там ещё изменения. Лучше мигрировать сейчас поэтапно, чем потом прыгать через две версии.

[arseny_lab]

shadcn/ui кстати отлично задокументировал совместимость с React 19 на своём сайте — там есть таблица компонентов и статус. Если используете shadcn, то апгрейд относительно безболезненный. Если свои компоненты или другие UI-киты — основная боль будет вокруг forwardRef, который в React 19 не нужен (ref теперь обычный prop). Старый код работает с deprecation warning, но лучше сразу почистить.

[ivan_quant]

Для коммерческого проекта с дедлайном через месяц — мой совет: не мигрируй прямо сейчас. Сначала закрой дедлайн, потом спокойно мигрируй на feature-ветке. Миграция Next.js 14 → 15 на среднем проекте (40-60к строк) у нас заняла 5 рабочих дней с тестированием. Это не 'сломалось половина проекта', это нормальный объём работы для мажорного обновления.