Next.js 업그레이드은(는) 무엇을 하나요?
공식 마이그레이션 가이드에 따라 현재 프로젝트를 최신 Next.js 버전으로 업그레이드합니다.
지침
-
현재 버전 감지:
package.json을 읽어 현재 Next.js 버전과 관련 의존성(React, React DOM 등)을 확인합니다. -
최신 업그레이드 가이드 가져오기: WebFetch를 사용하여 공식 업그레이드 문서를 가져옵니다.
-
업그레이드 경로 결정: 현재 버전을 기준으로 적용할 마이그레이션 단계를 식별합니다. 주요 버전 점프의 경우 단계적으로 업그레이드합니다 (예: 13 → 14 → 15).
-
먼저 코드 모드 실행: Next.js는 비호환 변경 사항을 자동화하는 코드 모드를 제공합니다.
npx @next/codemod@latest <transform> <path>일반적인 변환:
next-async-request-api- 비동기 Request API 업데이트 (v15)next-request-geo-ip- geo/ip 속성 마이그레이션 (v15)next-dynamic-access-named-export- 동적 임포트 변환 (v15)
-
의존성 업데이트: Next.js와 피어 의존성을 함께 업그레이드합니다.
npm install next@latest react@latest react-dom@latest -
비호환 변경 사항 검토: 업그레이드 가이드에서 수동으로 변경해야 할 사항을 확인합니다.
- API 변경 (예: v15의 비동기 params)
next.config.js의 설정 변경- 제거된 더 이상 사용되지 않는 기능
-
TypeScript 타입 업데이트 (해당되는 경우):
npm install @types/react@latest @types/react-dom@latest -
업그레이드 테스트:
npm run build실행하여 빌드 오류 확인npm run dev실행하여 주요 기능 테스트