Nuxt 3 지원 종료 후 Nuxt 4.5·Vite 8 마이그레이션 검증

핵심 답변: 2026년 7월 31일부로 Nuxt 3는 공식 지원이 끝났고, 현재 active package는 Nuxt 4다. 이 변화는 단순히 nuxt 버전을 올리는 문제가 아니다. Nuxt 4.5는 Vite 8, Rspack 2/Rsbuild 기반 builder, experimental SSR streaming, Nuxt 5 호환 준비를 담았고, Nuxt 3는 더 이상 버그 수정이나 보안 패치를 받지 않는다. 아직 v3 서비스가 운영 중이라면 다음 스프린트의 우선순위는 신기능이 아니라 지원 종료 위험을 측정 가능한 Nuxt 4 마이그레이션으로 바꾸는 것이다.

Gil처럼 Nuxt 프론트엔드와 운영을 함께 맡는 개발자에게 중요한 결론은 명확하다. 빌드가 통과한다고 migration이 끝난 것이 아니다. Vite 8의 Rolldown/Oxc 전환, browser target 상승, custom Vite plugin, SSR hydration, route casing, 배포 runtime을 함께 검증해야 한다. Nuxt 5의 future.compatibilityVersion: 5는 미리 변화량을 드러내는 좋은 도구지만, 아직 개발 중인 동작을 production 기본값으로 바꾸라는 뜻은 아니다.

오늘의 결론: Nuxt 3 앱은 v3 최신 패치에 머무르는 대신 Nuxt 4의 별도 브랜치·preview 환경을 만들고, build/SSR/route/cache/security smoke test로 승격한다. Nuxt 4.5의 새 빌드 계층과 streaming은 각각 독립 flag로 평가하자. 한 번의 업그레이드에 framework·bundler·rendering 전략을 모두 바꾸면 장애 원인을 분리할 수 없다.

무슨 일이 있었나

2026년 7월 18일, Nuxt 팀: Nuxt 4.5를 발표했다. 공식 릴리스 글은 Vite 8, Rspack 2와 Rsbuild 기반 Rspack builder, experimental SSR streaming, stable error code system, useLayout, named views, Nuxt 5를 위한 내부 의존성 정비를 핵심으로 든다. 같은 공지는 Nuxt 3의 2026년 7월 31일 EOL과 v3.21.9 maintenance patch를 설명했다.

2026년 7월 31일 이후, Nuxt 공식 Roadmap: Nuxt 3는 EOL이며 bug fix와 security patch를 더 이상 받지 않는다고 명시한다. 현재 active version은 npm latest 태그의 Nuxt 4다. GitHub release 목록상 최신 4.x 태그는 v4.5.2이며, 설치 전에는 lockfile과 모듈 호환 범위를 실제로 확인해야 한다.

업스트림 영향: Nuxt 4.5의 Vite 8 채택은 Vite 8 migration의 Rolldown·Oxc 전환을 함께 가져온다. Vite는 dependency optimizer가 Rolldown을 사용하며 optimizeDeps.esbuildOptions는 호환 변환은 되지만 deprecated라고 안내한다. default browser target도 Chrome 111, Edge 111, Firefox 114, Safari 16.4로 올라갔다.

왜 중요한가

확인된 사실: Nuxt 3 EOL, Nuxt 4 active status, Nuxt 4.5의 Vite 8 및 experimental SSR streaming은 공식 문서에 명시돼 있다. 해석: v3 유지 비용은 새 기능을 놓치는 비용을 넘어 결함·보안 수정의 기본 공급망에서 이탈하는 비용이 됐다. 불확실성: 앱별 module·custom plugin·Node runtime·hosting adapter가 어떤 회귀를 낼지는 일반 발표로 알 수 없다. 특히 experimental 표기가 있는 SSR streaming과 Nuxt 5 future 옵션은 자체 traffic과 observability로 검증해야 한다.

프론트엔드에는 browser target 변경이 번들 크기와 구형 브라우저 지원 정책을, 서버에는 Nitro rendering·cache·edge adapter가 영향을 준다. 같은 route라도 개발 서버·CI·preview·production에서 Node 버전과 환경 변수가 다르면 마이그레이션 결과도 달라진다. 따라서 “npm update 후 페이지를 열어 봤다”가 아니라 URL 매트릭스와 응답 헤더까지 비교해야 한다.

1. Nuxt 3 EOL은 보안 패치의 종료점이다

변경 내용: Nuxt Roadmap은 2026년 7월 31일부터 v3가 bug fix와 security patch를 받지 않는다고 밝힌다. 실제 영향: 새 취약점이나 framework-level 회귀가 발견돼도 공식 v3 수정으로 해결할 수 없으며, downstream module 패치만 기다리는 전략은 불완전하다. 적용/회피 조건: 즉시 대규모 재작성 대신 v3 자산 목록, 공개 server route, auth/session, image/upload, cache 경로를 위험도 순으로 분류한다. 단기적으로 지원 계약을 사용하더라도 Nuxt 4 이동 일정과 소유자를 고정한다. 검증 방법: package.json·lockfile·배포 이미지에서 Nuxt와 Node 버전을 수집하고, dependency audit, SAST, SSR route smoke test를 기준선으로 남긴다.

2. Vite 8은 plugin과 transform 설정의 호환성 시험이 핵심이다

변경 내용: Nuxt 4.5는 Vite 8을 사용하고 Vite 8은 Rolldown/Oxc 기반 도구로 이동한다. 실제 영향: custom Vite plugin, optimizeDeps, JSX transform, legacy esbuild option에 의존한 앱은 개발 시작·HMR·production bundle에서 서로 다른 회귀를 만날 수 있다. 적용/회피 조건: plugin을 최신 지원 범위와 peer dependency로 목록화하고, deprecated 옵션을 호환 레이어에만 의존하지 않게 rolldownOptions/oxc 이관 계획을 만든다. Safari 16.4 미만을 지원해야 한다면 target을 명시하고 polyfill 전략을 제품 요구와 함께 재검토한다. 검증 방법: clean install 후 nuxi typecheck, production build, cold dev start, HMR, chunk 분석을 CI에서 비교하고 지원 브라우저 실제 기기로 e2e를 실행한다.

3. SSR streaming은 TTFB 개선 가설이며 cache 계약 변경이다

변경 내용: Nuxt 4.5는 SSR streaming을 experimental로 제공한다. 실제 영향: 느린 데이터 일부를 기다리지 않고 HTML을 전송할 여지가 있지만, CDN buffering, error boundary, SEO crawler, hydration 순서, cache header가 기존과 달라질 수 있다. 적용/회피 조건: 개인화 페이지·결제·인증 callback처럼 완전한 응답과 오류 처리 계약이 중요한 경로에는 처음부터 적용하지 않는다. public content route 한 개를 flag로 골라 hosting provider가 chunked response를 실제 전달하는지 확인한다. 검증 방법: WebPageTest/RUM으로 TTFB·LCP·hydration error를 비교하고 curl -N로 첫 bytes와 종료 시점을 관찰한다. 봇 user-agent와 cache hit/miss, 4xx/5xx를 별도 대시보드로 본다.

4. Nuxt 5 compatibilityVersion은 migration linter로 사용한다

변경 내용: Nuxt 4.2+에서는 future.compatibilityVersion: 5로 Vite Environment API, case-sensitive routing, typed pages 등 Nuxt 5 기본 동작을 미리 시험할 수 있다. 실제 영향: 대소문자가 다른 내부 링크나 Options API, side-effect import가 숨겨져 있었다면 preview에서 조기에 발견한다. 적용/회피 조건: 설정은 별도 preview branch/environment에서만 켜고 route canonical URL과 redirect 규칙을 먼저 정의한다. docs가 “subject to change”라고 명시하므로 이를 확정 호환 보증으로 쓰지 않는다. 검증 방법: sitemap URL 전수와 analytics 상위 landing URL을 casing 포함해 요청하고, 200/301/404 분포, typed route typecheck, client hydration 오류를 기준 브랜치와 비교한다.

개발자 실행 계획

P0: package.json, lockfile, Dockerfile/hosting 설정에서 Nuxt·Node·Vite·module 버전을 inventory로 추출한다.
P0: docs/nuxt3-eol-migration.md에 공개 route, auth, server API, image, cache의 소유자·위험도·Nuxt 4 목표일을 기록한다.
P1: Nuxt 4.5.2 후보 브랜치에서 npx nuxt upgrade를 실행하고 clean install, typecheck, lint, unit, build를 CI artifact로 보관한다.
P1: vite.plugins, optimizeDeps, esbuild 설정과 peer dependency를 audit하고 Vite 8 지원 여부를 표로 만든다.
P1: preview에서 SSR URL matrix(정상·404·redirect·인증·에러)와 response header/cache policy를 production 기준선과 diff한다.
P2: streaming은 public route 하나에만 flag로 적용하고 TTFB, LCP, hydration error, crawler 응답을 7일 비교한다.
P2: 별도 CI job에서 future.compatibilityVersion: 5를 켜고 route casing·typed page·Options API 경고를 backlog로 전환한다.

리스크와 한계

Nuxt 4.5의 SSR streaming은 experimental이므로 성능 개선을 보장하지 않는다. Vite 8 migration은 plugin 생태계와 브라우저 지원 정책을 함께 바꾸며, 호환 변환이 현재 작동해도 deprecated API의 장기 안전성을 보장하지 않는다. 롤백 조건은 preview 5xx/hydration error 증가, cache miss 급증, 핵심 route의 LCP 악화, 지원 브라우저 기능 실패다. 이때 production alias를 이전 image로 되돌리고, framework upgrade와 streaming flag를 분리해 원인을 좁힌다. Nuxt 5 관련 옵션도 출시 전 변경될 수 있으므로 production 계약으로 고정하지 않는다.

FAQ

Nuxt 3는 2026년 8월에도 계속 써도 되나?

실행은 가능하지만 공식 문서상 7월 31일부터 bug fix와 security patch를 받지 않는다. 위험도 평가와 Nuxt 4 migration 계획 없이 장기 운영하는 것은 권장되지 않는다.

Nuxt 4.5로 올리면 Vite 설정을 무조건 고쳐야 하나?

대부분의 앱은 투명하게 업그레이드될 수 있지만 custom plugin·직접 Vite 의존성·esbuild 기반 optimize 설정은 Vite 8 migration 문서를 기준으로 반드시 빌드와 HMR을 검증해야 한다.

SSR streaming을 켜면 SEO와 성능이 항상 좋아지나?

아니다. streaming은 experimental이며 CDN buffering, crawler 처리, hydration, cache header에 좌우된다. public route의 feature flag와 실측 TTFB/LCP/HTML 검증으로만 확대해야 한다.

출처 및 추가 읽기

더 깊게 읽기: 실전 가이드

이 리포트는 최근 흐름을 빠르게 파악하기 위한 요약입니다. 실제 프로젝트에 적용할 때는 아래의 기준 글과 함께 확인하면 더 안전합니다.

Nuxt 3 지원 종료 후 Nuxt 4.5·Vite 8 마이그레이션 검증 | Nuxt 4.5 Migration Verification