Upgrade Next.js
Aktualisieren Sie das aktuelle Projekt auf die neueste Next.js-Version gemäß der offiziellen Migrationsleitfäden.
Anleitung
-
Aktuelle Version erkennen: Lesen Sie
package.json, um die aktuelle Next.js-Version und zugehörige Abhängigkeiten (React, React DOM usw.) zu identifizieren. -
Den neuesten Upgrade-Leitfaden abrufen: Verwenden Sie WebFetch, um die offizielle Upgrade-Dokumentation zu laden:
- Codemods: https://nextjs.org/docs/app/building-your-application/upgrading/codemods
- Versionsspezifische Leitfäden (Version nach Bedarf anpassen):
-
Upgrade-Pfad bestimmen: Basierend auf der aktuellen Version identifizieren, welche Migrationsschritte anwendbar sind. Bei größeren Hauptversionssprüngen schrittweise upgraden (z. B. 13 → 14 → 15).
-
Codemods zuerst ausführen: Next.js bietet Codemods zur Automatisierung von Breaking Changes:
npx @next/codemod@latest <transform> <path>Häufige Transforms:
next-async-request-api- Aktualisiert asynchrone Request-APIs (v15)next-request-geo-ip- Migriert geo/ip-Eigenschaften (v15)next-dynamic-access-named-export- Transformiert dynamische Importe (v15)
-
Abhängigkeiten aktualisieren: Next.js und Peer-Abhängigkeiten zusammen upgraden:
npm install next@latest react@latest react-dom@latest -
Breaking Changes überprüfen: Den Upgrade-Leitfaden auf manuell erforderliche Änderungen prüfen:
- API-Änderungen (z. B. asynchrone Parameter in v15)
- Konfigurationsänderungen in
next.config.js - Entfernte veraltete Funktionen
-
TypeScript-Typen aktualisieren (falls zutreffend):
npm install @types/react@latest @types/react-dom@latest -
Das Upgrade testen:
- Führen Sie
npm run buildaus, um auf Build-Fehler zu prüfen - Führen Sie
npm run devaus und testen Sie die wichtigsten Funktionen
- Führen Sie