1. 마이그레이션 준비 과정

1.1 의존성 호환성 검토

• 버전업 필요:
  • @react-email/components
• peer dependencies 수정 필요:
  • @repo/cosmax
  • @repo/domain
  • @repo/exanadu
  • @repo/notification
  • @repo/toss
  • @repo/ui

1.2 타입 시스템 변경 검토

React 19의 타입 시스템 변경으로 인해 다음 사항들을 고려해야 했다.

• ReactNode와 Promise<ReactNode> 분리
• ReactPortal 타입의 children 속성 필수화
• ReactElement 타입의 호환성 강화

2. 트러블 슈팅

2.1 next-auth 비동기 API 호환성 이슈

문제 상황:

headers().get('x-forwarded-proto')가 Next.js 15의 비동기 API로 인해 동작하지 않음

원인:

next-auth 5.0.0-beta.21에서 동기적 headers() 호출을 사용해 비호환 발생

해결 및 효과:

• next-auth를 5.0.0-beta.25로 업그레이드하여 비동기 API 지원
• 헤더 처리 오류 감소 및 안정성 확보
• 타입스크립트 경고 제거 및 타입 안정성 개선

2.2 서버 컴포넌트 Props Promise 이슈