EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-002: Paketdokument nicht gefunden

Aktualisiert: 4. November 2026

EPUBCheck OPF-002 ist eine kritische Fehlermeldung: „The OPF file "…" was not found in the EPUB.“ Das im META-INF/container.xml genannte Paketdokument befindet sich nicht im Archiv. EPUBCheck stoppt dort, da das Paketdokument jede andere Datei auflistet, sodass nichts anderes im Buch geprüft werden kann, bis es gefunden wird.

Die offizielle Nachricht

The OPF file "%1$s" was not found in the EPUB.

Standard-Schweregrad: Fataler Fehler. EPUBCheck konnte diese Teilprüfung des EPUB nicht fortsetzen. Die Datei ist ungültig.
EPUBCheck Version: 5.4.0

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

Typische Ursachen

Ein vollständiger Pfad in container.xml, der nicht mit dem echten Pfad der .opf-Datei übereinstimmt, oft ein Unterschied in Groß- oder Kleinschreibung.
Die .opf-Datei wurde umbenannt oder wurde nach dem Schreiben von container.xml in einen anderen Ordner verschoben.
Die .opf-Datei wurde ausgelassen, als der Ordner gezippt wurde.

Wie man es behebt

Öffnen Sie META-INF/container.xml und lesen Sie das full-path Attribut des rootfile Elements.
Vergleichen Sie es mit dem tatsächlichen Standort der .opf-Datei im Archiv, Buchstabe für Buchstabe: Pfade in einem EPUB sind groß-/kleinschreibungsempfindlich.
Korrigieren Sie den vollständigen Pfad (oder verschieben Sie die Datei), damit sie übereinstimmen, und bauen Sie dann das EPUB neu auf.

Wann es nicht das ist

Wenn container.xml selbst fehlt, weist EPUBCheck auf RSC-002 hin.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-001 There was an error when parsing the EPUB version: ….
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, §4.2.6.3.1.3 The rootfile 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-002?

Ist OPF-002 ein Fehler?

OPF-002 wird standardmäßig als schwerwiegender Fehler gemeldet. EPUBCheck konnte diese Teilprüfung des EPUB nicht fortsetzen. Die Datei ist ungültig.