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` 오류 조건에 해당하고, 하나이면 이 문서의 오류 조건에 해당하지 않습니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
`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 />를 여러 개 사용하는 경우 애플리케이션에서 예상하지 못한 동작이 발생할 수 있습니다.
참고 자료
No Duplicate Head | Next.js (새 창에서 열림)
Next.js · 공식 자료 · 확인 범위: Next.js 공식 문서의 오류 제목은 "No Duplicate Head"입니다., 하나의 custom document에서 <Head />가 둘 이상 사용되면 이 오류가 발생할 수 있습니다., pages/_document.js의 custom document에서는 <Head />를 하나만 사용해야 합니다. · 확인일: 2026-07-28