No Duplicate Head
pages/_document.js의 하나의 custom document에서 <Head />가 둘 이상 사용된 상태입니다.
빠른 답변
- 우선 확인할 원인
- pages/_document.js의 custom document에서 <Head />를 하나만 사용하면 됩니다.
- 먼저 확인할 항목
- `pages/_document.js`의 하나의 custom document에서 `<Head />` 사용 개수를 확인합니다. `<Head />`가 둘 이상이면 `No Duplicate Head` 오류 조건에 해당하고, 하나이면 이 문서의 오류 조건에 해당하지 않습니다.
- 적용 범위
- 현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우문맥: 바이브 코딩
- 출처
- Next.js
- 출처 확인일
- 2026-07-28
- 최종 검토
- 2026-07-28
- 수정일
- 2026-07-30
- 정정 이력
- 2026-07-29 이후 기록 없음
- 관련 기술
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
`pages/_document.js`의 하나의 custom document에서 `<Head />` 사용 개수를 확인합니다. `<Head />`가 둘 이상이면 `No Duplicate Head` 오류 조건에 해당하고, 하나이면 이 문서의 오류 조건에 해당하지 않습니다.
`pages/_document.js`의 custom document를 확인한 뒤 `<Head />`를 하나만 남겼는지 확인합니다. 하나만 사용한 상태가 공식 문서가 제시한 기대 상태입니다.
환경별 원인과 조치
확인
pages/_document.js의 하나의 custom document에서 <Head />가 둘 이상 사용되었는지 확인합니다. 둘 이상의 <Head />가 있으면 No Duplicate Head 오류 조건에 해당합니다.
조치
pages/_document.js의 custom document에서 <Head />를 하나만 사용합니다.
주의
<Head />를 여러 개 사용하는 경우 애플리케이션에서 예상하지 못한 동작이 발생할 수 있습니다.
관찰값 기록
문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.
다음 항목을 실제 값과 함께 확인합니다.
pages/_document.js의 하나의 custom document에서<Head />사용 개수를 확인합니다.<Head />가 둘 이상이면No Duplicate Head오류 조건에 해당하고, 하나이면 이 문서의 오류 조건에 해당하지 않습니다.pages/_document.js의 custom document를 확인한 뒤<Head />를 하나만 남겼는지 확인합니다. 하나만 사용한 상태가 공식 문서가 제시한 기대 상태입니다.
판정 기준
오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.
안전한 다음 확인
설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.
참고 자료
Next.js · 공식 자료 · 확인 범위: Next.js 공식 문서의 오류 제목은 "No Duplicate Head"입니다., 하나의 custom document에서 <Head />가 둘 이상 사용되면 이 오류가 발생할 수 있습니다., pages/_document.js의 custom document에서는 <Head />를 하나만 사용해야 합니다. · 확인일: 2026-07-28