EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-001: unlesbare EPUB-Version

Aktualisiert: 4. November 2026

EPUBCheck OPF-001 ist eine Fehlermeldung: „There was an error when parsing the EPUB version: ….“ EPUBCheck konnte die EPUB-Version aus dem Paketdokument nicht lesen. Das Attribut version im Paketelement informiert Validatoren und Lese-Apps darüber, welcher Regelensatz im Buch verwendet wird, sodass ohne einen lesbaren Wert die restliche Überprüfung nicht zuverlässig ist.

Die offizielle Nachricht

There was an error when parsing the EPUB version: %1$s.

Standard-Schweregrad: Fehler. Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
EPUBCheck Version: 5.4.0

%1$s, %2$s… werden mit der Datei, dem Wert oder dem Element EPUBCheck ausgefüllt.

Typische Ursachen

Ein fehlendes oder leeres Versionsattribut im Paket-Element.
Ein fehlerhafter Wert, wie version="3" oder version="EPUB 3", anstelle einer Zahl wie 3.0.
Ein Paketelement, das von Hand oder von einem Skript verfasst wurde, das das Attribut weggelassen hat.

Wie man es behebt

Öffnen Sie das Paketdokument (die .opf Datei) und suchen Sie das Paket-Element oben.
Setzen Sie version="3.0" für EPUB 3 (EPUB 3.3 Bücher deklarieren immer noch 3.0) oder version="2.0" für EPUB 2.
Führen Sie EPUBCheck erneut aus: Fehler, die von der Version abhingen, sollten jetzt korrekt angezeigt werden.

Wann es nicht das ist

Wenn EPUBCheck die Version liest, Sie jedoch eine andere mit -v angefordert haben, ist das PKG-001, nicht OPF-001.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-002 The OPF file "…" was not found in the EPUB.
OPF-003 Item "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-007 Re-declaration of reserved prefix "…".

Quellen

EPUB 3.3, §5.4 The package element · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck OPF-001?

Ist OPF-001 ein Fehler?

OPF-001 wird standardmäßig als Fehler gemeldet. Die EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Send to Kindle können es ablehnen, und EPUBCheck beendet sich mit Status 1.