Unhead 3.3와 Nuxt·Vue main 변경으로 보는 빌드·Hydration 운영 | Build and Hydration Operations across Unhead, Nuxt, and Vue

요약: 2026년 8월 2~5일의 Nuxt·Vue·Vite 프론트엔드 흐름은 “바로 올릴 수 있는 Unhead 릴리즈”와 “아직 main에서 검증 중인 Nuxt/Vue/Vite 변경”을 분리해 운영하는 일이다. Nuxt 개발팀은 Head 변환 의존성, SSR hydration 입력값, Vite·Rolldown 기반 개발 서버를 각각 잠금파일·스테이징·회귀 테스트로 확인해야 한다.

핵심 답변: 이번 3일에 무엇을 해야 하나?

결론: 배포 가능한 변경은 Unhead 3.3.0/3.3.1이다. 특히 Unhead Bundler를 Vite 6·7, webpack, Rspack 또는 Rollup에서 쓰면서 Rolldown을 설치하지 않은 프로젝트는 oxc-parser를 개발 의존성으로 명시해야 한다. 반면 Nuxt CLI v4 프리릴리즈, Vue의 hydration 입력값 보존, Vite bundled-dev 정비는 모두 main 브랜치 작업이므로 지금 프로덕션 버전으로 간주하거나 잠금파일에 직접 반영하면 안 된다.

릴리즈: Unhead v3.3.0(8월 3일)과 v3.3.1(8월 4일)은 공식 배포본이다.
개발 중: Nuxt의 CLI v4 프리릴리즈 채택 및 Vite·Rolldown 갱신, Vue의 v-model hydration 수정, Vite bundled-dev 변경은 아직 main 기준이다.
실무 우선순위: Head 변환을 사용하는 빌드부터 CI에서 재현하고, SSR 폼과 개발 서버는 별도 스테이징에서 회귀 테스트한다.

1. Unhead 3.3: Head 변환 의존성을 명시하는 빌드 전환

사실: Unhead v3.3.0은 8월 3일 공개됐다. 릴리즈 노트는 Vite 6·7, webpack, Rspack, Rollup 등 Rolldown이 아닌 빌드에서 Unhead Bundler를 사용할 경우 oxc-parser가 더 이상 자동 제공되지 않으며, 직접 개발 의존성으로 설치해야 한다고 안내한다. Rolldown이 설치된 빌드와 런타임 전용 프로젝트는 해당 조치가 필요 없다.

시사점: Nuxt 애플리케이션에서 @unhead/bundler 변환이나 정적 인라인 스크립트 변환을 쓰는 팀은 “로컬에서만 통과하는 간접 의존성”에 기대지 말아야 한다. CI의 깨끗한 설치 환경에서 빌드가 재현되는지를 확인하는 것이 SEO 메타데이터와 배포 안정성을 함께 지키는 가장 짧은 경로다.

같은 흐름의 후속 패치

v3.3.1(8월 4일)은 source가 없는 SDK loader를 지원하는 scripts 수정 패치다. SDK 스크립트를 Head 레이어에서 관리하는 사이트는 업데이트 후 실제 태그 삽입·로드 순서를 브라우저에서 확인할 가치가 있다. 이는 기능 확대가 아니라 릴리즈된 호환성 보정으로 판단해야 한다.

2. Nuxt의 Vite·Rolldown 수렴은 main 단계: 버전 고정이 먼저다

사실: Nuxt main에는 8월 3일 Vite와 Rolldown 의존성 갱신 커밋이 반영됐고, 8월 4일에는 @nuxt/cli v4 프리릴리즈 사용 커밋이 이어졌다. 두 항목은 새 Nuxt 안정 릴리즈가 아니라 main 브랜치의 개발 작업이다.

시사점: Vite·Rolldown 생태계가 Nuxt의 다음 개발 흐름에 더 깊이 연결되고 있다는 신호이지만, 앱의 package.json을 prerelease로 밀어 올리라는 뜻은 아니다. 특히 플러그인, custom Vite config, 모노레포의 lockfile은 도구체인 변화에 민감하다. 현재 안정 버전을 고정하고, 별도 브랜치에서 설치·빌드·E2E 결과를 비교하는 편이 안전하다.

참고로 최근 안정 Nuxt 4.5.1/3.21.10은 보안 릴리즈이므로 아직 적용하지 않은 프로젝트는 공식 보안 릴리즈 노트의 업그레이드 및 캐시 정리 지침을 우선 확인해야 한다. 이 보안 릴리즈는 이번 72시간에 새로 나온 변경은 아니지만, 이번 main 의존성 흐름을 검토하는 팀의 기준선이다.

3. Vue hydration 입력 보존: SSR 폼을 main 변경으로 먼저 재현한다

사실: Vue core main에는 8월 4일 hydration 전에 사용자가 입력한 텍스트를 v-model이 보존하도록 하는 수정이 들어갔다. 변경 파일은 runtime DOM의 vModel 구현과 hydration 테스트다. 이 역시 아직 정식 Vue 릴리즈 노트가 아닌 main 커밋이다.

시사점: SSR 페이지에서 사용자가 hydration 완료 전에 검색어·쿠폰·로그인 입력을 시작할 수 있다면, 현재 배포 버전에서 그 입력이 덮어써지지 않는지 실제 네트워크 지연 조건으로 점검해야 한다. main 변경을 즉시 채택하지 말고, 현행 Vue 버전의 결함 재현 여부와 향후 패치 릴리즈 포함 여부를 이슈 추적 대상으로 분리한다.

4. Vite bundled-dev 정비: 개발 피드백 루프의 회귀 테스트를 강화

사실: Vite main은 8월 4일 bundled-dev 번들에 서버 값을 주입하지 않도록 정비했고, CSS·assets playground 활성화와 legacy watch flaky failure 보정도 같은 기간 진행했다. 이들은 main 작업이며, 새 Vite 릴리즈가 아니다. 가장 최근 공개된 안정판은 Vite 8.2.0이고, 공식 changelog에는 bundled-dev 재빌드 후 단일 reload 및 worker 파일 HMR 수용 등이 기록돼 있다.

시사점: 개발 서버 인프라를 바꾸는 변경은 production 번들 성능보다 먼저 HMR, worker, CSS/assets 수정, 서버 재시작 시 상태 보존을 점검해야 한다. Nuxt의 Vite 통합을 쓰는 팀은 “빌드 성공”만으로 도구체인 갱신을 승인하지 말고, 실제 개발 루프를 품질 기준에 넣어야 한다.

프론트엔드 개발자 적용 체크리스트

Head/SEO: @unhead/bundler와 비-Rolldown 빌드를 쓰는지 찾고, 해당하면 pnpm add -D oxc-parser 후 clean install과 production build를 CI에서 실행한다.
의존성 관리: Nuxt main의 CLI·Vite·Rolldown 커밋은 관찰 대상으로 기록하고, prerelease는 별도 검증 브랜치와 lockfile에서만 시험한다.
SSR UX: 느린 hydration 조건에서 텍스트 입력·검색 폼을 자동화 테스트해 입력값이 보존되는지 확인한다.
개발 서버: Vite/Nuxt 업그레이드 후보마다 HMR, worker 변경, CSS·asset 변경, legacy browser watch를 포함한 짧은 smoke test를 수행한다.
보안 기준선: Nuxt 4.5.1 또는 3.21.10 보안 패치 적용 여부와 cache/swr/isr 사용 시 CDN·edge cache 정리 여부를 확인한다.

짧은 Q&A

Q. 지금 Nuxt CLI v4 프리릴리즈나 Vue main을 설치해야 하나?

A. 아니다. 이번 72시간에 확인된 항목은 main 브랜치 커밋이며 정식 배포가 아니다. 릴리즈 노트가 나온 뒤 changelog, peer dependency, 프로젝트 회귀 테스트를 통과시키고 채택한다.

Q. Unhead 3.3 업데이트는 모든 Nuxt 앱에 영향이 있나?

A. 아니다. 핵심 변경은 Unhead Bundler와 Rolldown 없는 변환 빌드에 해당한다. 런타임 전용 또는 Rolldown 설치 환경은 릴리즈 노트상 추가 설치가 필요 없다. 다만 프로젝트의 실제 빌드 경로를 먼저 확인해야 한다.

3일 결론

이번 기간의 핵심은 새 기능 경쟁보다 빌드·Head·hydration 경계에서 릴리즈와 개발 브랜치를 정확히 구분하는 운영이다. 즉시 적용할 수 있는 것은 Unhead의 명시적 의존성 점검과 안정 보안 기준선 확인이다. Nuxt CLI v4, Vite·Rolldown 수렴, Vue hydration 수정은 방향성은 유의미하지만 아직 검증 대상이다. 이 구분을 지키면 SEO 태그, SSR 입력 경험, 개발 서버 생산성을 동시에 흔들지 않고 다음 업그레이드를 준비할 수 있다.

주요 출처

더 깊게 읽기: 실전 가이드

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