EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-048: fehlender unique-identifier

Aktualisiert: 4. November 2026

EPUBCheck OPF-048 ist eine Fehlermeldung: „Package tag is missing its required unique-identifier attribute and value.“ Das Paket-Element hat kein unique-identifier Attribut, das erforderlich ist. Es verweist auf die dc:identifier, die das Buch identifiziert, und Leseanwendungen verwenden es, um Bücher und Ausgaben zu unterscheiden.

Die offizielle Nachricht

Package tag is missing its required unique-identifier attribute and value.

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

Typische Ursachen

Ein Paketdokument, das von Hand oder von einem Tool verfasst wurde, das es weggelassen hat.
Das Attribut war falsch geschrieben, wie uniqueidentifier oder unique-id.
Ein Paketelement, das beim Zusammenführen von Büchern ersetzt wurde.

Wie man es behebt

Stellen Sie sicher, dass die Metadaten ein dc:identifier mit einer ID haben, zum Beispiel <dc:identifier id="uid">urn:uuid:…</dc:identifier>.
Fügen Sie die unique-identifier mit dieser ID zum Paket-Element hinzu, zum Beispiel <package version="3.0" unique-identifier="uid">.
Führen Sie EPUBCheck erneut aus, um zu bestätigen, dass die beiden übereinstimmen.

Wann es nicht das ist

Wenn das Attribut vorhanden ist, aber auf eine ID zeigt, die kein dc:identifier hat, ist das OPF-030.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-049 Item id "…" was not found in the manifest.
OPF-050 TOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-045 Encountered circular reference in fallback chain.
OPF-044 Spine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-043 Spine item with non-standard media-type "…" has no fallback.
OPF-053 Date value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….

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-048?

Ist OPF-048 ein Fehler?

OPF-048 wird standardmäßig als Fehler gemeldet. Der EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Geschäfte und das Senden an Kindle können es ablehnen, und EPUBCheck beendet mit Status 1.