EPUB 검증 오류 사례

GomsBook/전자책 검증 · 접근성

EPUB 검증 오류 사례

오마로 2026. 1. 11. 10:21

전자책 검증에서 가장 많이 탈락하는 이유들

EPUB 전자책을 만들고 나면
마지막으로 반드시 거쳐야 하는 과정이 있습니다.
바로 EPUB 검증입니다.

이 단계에서 많은 전자책이
내용과는 무관하게 탈락합니다.

“왜 안 되는지 모르겠다”
“어제까지 잘 열리던 전자책인데…”

이 글에서는 실제 EPUB 검증에서 가장 많이 발생하는 오류 사례를 중심으로,
전자책 제작자가 반드시 알고 있어야 할 포인트를 정리합니다.

EPUB 검증이란 무엇인가

EPUB 검증은
전자책이 표준 구조를 제대로 지키고 있는지를 확인하는 과정입니다.

검증에서는 다음을 중점적으로 봅니다.

EPUB 파일 구조의 정확성
XHTML 문법 오류 여부
목차 및 리소스 연결 상태
접근성 관련 필수 요소

즉, **보이느냐보다 “맞게 만들어졌느냐”**가 기준입니다.

오류 사례 1. XHTML 문법 오류

가장 기본적이면서도
가장 많이 발생하는 오류입니다.

대표적인 원인

태그를 닫지 않음
중첩 구조가 잘못됨
잘못된 속성 사용

웹에서는 문제없이 보이더라도
EPUB에서는 문법 오류 = 검증 실패로 이어질 수 있습니다.

왜 문제가 될까

EPUB은 XML 기반이기 때문에
문법에 매우 엄격합니다.
사소한 실수 하나가 전체 검증 실패로 연결됩니다.

오류 사례 2. 이미지 대체 텍스트(alt) 누락

전자책 검증에서
최근 가장 중요해진 항목 중 하나입니다.

대표적인 문제

img 태그에 alt 속성이 없음
의미 있는 이미지인데 설명이 비어 있음

왜 문제가 될까

이미지 대체 텍스트는
접근성 기준에서 필수 요소입니다.

특히 지원사업이나 공공 검증에서는
alt 누락만으로도 탈락 사유가 될 수 있습니다.

오류 사례 3. 목차(nav.xhtml) 연결 오류

목차는 전자책의 길잡이입니다.
하지만 다음과 같은 실수가 매우 자주 발생합니다.

대표적인 문제

목차 링크 경로 오류
존재하지 않는 파일을 참조
제목 구조(h1, h2)와 불일치

왜 문제가 될까

전자책 뷰어는
nav.xhtml를 기준으로 내비게이션을 구성합니다.

목차가 틀리면
전자책은 “읽을 수는 있지만 사용할 수 없는 책”이 됩니다.

오류 사례 4. OPF 파일 리소스 불일치

EPUB 검증에서
의외로 많이 발생하는 오류입니다.

대표적인 문제

실제 파일은 있는데 OPF에 등록되지 않음
OPF에 등록했지만 파일이 존재하지 않음
media-type 오류

왜 문제가 될까

OPF 파일은
EPUB 전체 리소스를 관리하는 목록 파일입니다.

하나라도 맞지 않으면
EPUB 구조 자체가 깨진 것으로 판단됩니다.

오류 사례 5. 접근성 메타데이터 누락

최근 EPUB 검증에서는
접근성 메타데이터도 중요한 기준입니다.

대표적인 문제

접근성 관련 메타데이터 미기재
구조적 태그 사용 부족
의미 없는 div 남용

왜 문제가 될까

전자책은 이제
모든 사용자를 고려해야 하는 콘텐츠로 분류됩니다.

접근성 요소는
선택 사항이 아니라 기본 요건이 되고 있습니다.

왜 이런 오류가 반복될까

이 오류들의 공통점은 하나입니다.

내용의 문제가 아니라 구조의 문제

대부분의 제작자는
“글이 잘 보이는데 왜 탈락하지?”라고 생각합니다.

하지만 검증은
사람이 아니라 기계 기준으로 진행됩니다.

그래서 구조 관리가 무엇보다 중요합니다.

EPUB 검증 오류를 줄이는 방법

가장 확실한 방법은 다음과 같습니다.

구조를 수동으로 관리하지 않는다
검증 기준을 반영한 환경에서 제작한다
반복되는 오류를 자동으로 예방한다

이 때문에 실무에서는
EPUB 구조와 검증을 고려한 전자책 프로그램을 사용하게 됩니다.

프로그램은 오류를 대신 관리하고,
제작자는 콘텐츠에 집중할 수 있게 됩니다.