EPUBCheck · Paket und ZIP-Container

EPUBCheck PKG-022: Bilderweiterung stimmt nicht überein

Aktualisiert: 4. November 2026

EPUBCheck PKG-022 ist eine Warnmeldung: „Wrong file extension for image. The image is a "…" file but has the file extension "…".“ Die Erweiterung eines Bildes stimmt nicht mit seinem tatsächlichen Format überein, z. B. eine PNG-Datei, die .jpg genannt wird. Die meisten Lese-Apps zeigen es trotzdem an, aber Tools, die der Erweiterung oder dem Medientyp des Manifests vertrauen, können fehlschlagen.

Die offizielle Nachricht

Wrong file extension for image. The image is a "%1$s" file but has the file extension "%2$s".

Standard-Schweregrad: Warnung. Die EPUB ist weiterhin gültig, aber irgendetwas wird wahrscheinlich Probleme in einigen Leseanwendungen verursachen. EPUBCheck beendet die Ausführung mit 0, es sei denn, Sie übergeben --failonwarnings.
EPUBCheck Version: 5.4.0

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

Typische Ursachen

Bilder, die umbenannt und nicht konvertiert werden.
Tools, die in einem Format speichern, aber die alte Erweiterung beibehalten.

Wie man es behebt

Entweder benennen Sie die Datei in die richtige Erweiterung um oder konvertieren Sie sie in das Format, das der Name angibt.
Machen Sie den Medientyp des Manifests auch passend zum tatsächlichen Format (image/png, image/jpeg…).
Nach der Umbenennung aktualisieren Sie jede Referenz zur Datei: das Manifest im Paketdokument, Links und Bildquellen in der XHTML und url()-Referenzen im CSS.

Wann es nicht das ist

Wenn das Bild überhaupt nicht dekodiert werden kann, ist die Nachricht PKG-021.

Hier verwendete Begriffe

Andere PKG Nachrichten

PKG-021 Corrupted image file encountered.
PKG-023 Validating the EPUB against version 2.0, default validation profile will be used.
PKG-020 OPF file "…" could not be found.
PKG-025 Publication resource must not be located in the META-INF directory
PKG-018 The EPUB file could not be found.
PKG-026 Obfuscated resource must be a Font Core Media Type (was declared as "…" in "…").

Quellen

EPUB 3.3, §3.2 Core media types · lesen 4. November 2026
EPUB 3.3, §5.6.2 The item 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 PKG-022?

Ist PKG-022 ein Fehler?

PKG-022 wird standardmäßig als Warnung gemeldet. Die EPUB ist nach wie vor gültig, aber etwas könnte Probleme in einigen Leseanwendungen verursachen. EPUBCheck endet mit 0, es sei denn, Sie geben --failonwarnings an.