에러 백과

하이드레이션 중 텍스트 누락

이 오류는 NG0500 오류와 비슷하지만, Angular의 하이드레이션 과정에서 DOM의 특정 위치에 텍스트 노드가 있을 것으로 예상했으나 아무것도 찾지 못했다는 뜻입니다. 직접적인 DOM 조작과 관련된 원인은 NG0500 오류 페이지에서 확인하세요.

일반적인 원인: 하이드레이션 전에 변경된 서버 HTML

하이드레이션은 서버 사이드 렌더링으로 생성된 텍스트 노드를 재사용합니다. 브라우저가 애플리케이션을 실행하기 전에 무언가가 이 텍스트 노드를 제거하거나 병합하면 Angular가 찾는 노드가 사라집니다.

흔한 원인으로는 HTML 압축 도구, 응답을 다시 작성하는 프록시나 CDN, 브라우저 확장 프로그램, Angular 외부에서 innerHTML로 텍스트를 작성하는 애플리케이션 코드가 있습니다.

오류 디버깅

직접적인 DOM 조작과 관련된 원인을 디버깅하는 방법은 NG0500 오류를 참고하세요.

서버가 보낸 HTML과 브라우저가 받은 HTML을 비교하세요. 엘리먼트 검사기는 하이드레이션이 이미 실행된 후의 DOM을 보여 주므로, 검사기 대신 페이지 소스를 확인하세요. 서버 응답에는 텍스트가 있지만 브라우저에는 없다면 중간에서 HTML을 다시 작성하는 도구가 있는지 찾아보세요.

컴포넌트의 HTML을 제어할 수 없다면 최후의 수단으로 호스트 노드에 ngSkipHydration 어트리뷰트를 추가할 수 있습니다. 이렇게 하면 해당 컴포넌트와 자식 컴포넌트의 하이드레이션이 비활성화됩니다. 이는 수정해야 할 버그로 간주해야 합니다.