EPUBCheck · Pacote e contêiner ZIP

EPUBCheck PKG-001: discrepância de versão EPUB

Atualizado: 4 de Novembro de 2026

EPUBCheck PKG-001 é uma mensagem de aviso: “Validating the EPUB against version … but detected version ….” EPUBCheck foi instruído a validar uma versão EPUB, mas o documento do pacote declara outra. A versão vem do atributo version do elemento de pacote, e EPUBCheck relata a discrepância como um aviso antes de aplicar as regras da versão solicitada.

A mensagem oficial

Validating the EPUB against version %1$s but detected version %2$s.

Severidade padrão: Aviso. O EPUB ainda é válido, mas algo provavelmente causará problemas em alguns aplicativos de leitura. EPUBCheck sai com 0, a menos que você passe --failonwarnings.
versão EPUBCheck: 5.4.0

%1$s, %2$s… são preenchidos com o arquivo, valor ou elemento EPUBCheck encontrado.

Causas típicas

EPUBCheck foi executado com -v 2.0 ou -v 3.0 e o elemento do pacote do arquivo tem um atributo de versão diferente.
Um script de construção ou serviço de validação que sempre passa a mesma opção -v, não importa qual seja o livro.
Um livro meio convertido de EPUB 2 para EPUB 3 cujo atributo de versão não foi atualizado.

Como consertar isso

Execute EPUBCheck sem -v em um arquivo .epub empacotado: ele lê a versão do documento do pacote.
Se o atributo de versão em si estiver errado, defina-o para a versão que o conteúdo realmente segue: version="3.0" para EPUB 3.
Valide novamente e corrija as mensagens para a versão correta.

Quando não é isso

Se o EPUBCheck disser que está validando contra 2.0 com o perfil padrão, isso é o informativo PKG-023, não uma divergência.

Termos usados aqui

Outras mensagens de PKG

PKG-003 Unable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004 Corrupted EPUB ZIP header.
PKG-005 The mimetype file has an extra field of length …. The use of the extra field feature of the ZIP format is not permitted for the mimetype file.
PKG-006 Mimetype file entry is missing or is not the first file in the archive.
PKG-007 The content of the mimetype file must be the string "application/epub+zip"…
PKG-008 Unable to read file "…".

Fontes

EPUB 3.3, §5.4 The package element · ler 4 de Novembro de 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · ler 4 de Novembro de 2026

Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.

FAQ

O que significa EPUBCheck PKG-001?

É um erro PKG-001?

PKG-001 é reportado como aviso por padrão. O EPUB ainda é válido, mas algo pode causar problemas em alguns aplicativos de leitura. EPUBCheck sai com 0, a menos que você passe --failonwarnings.