Was führt dazu, dass HEIC-Fotos in einer selbst gehosteten Galerie ihre Vorschauen verlieren?

HEIC-Vorschauen verschwinden, wenn die Galerie das Original nicht decodieren, kein abgeleitetes Bild erzeugen oder dieses abgeleitete Bild nicht an den aktuellen Client ausliefern kann.

Eine selbst gehostete Galerie bewahrt das HEIC-Original normalerweise auf und erstellt JPEG- oder WebP-Miniaturansichten und Vorschauen für Browser und Smartphones, die möglicherweise nicht jedes HEIF-Profil direkt anzeigen können. Das Original kann weiterhin herunterladbar sein, auch wenn die Zeitleiste leer bleibt, weil Beschädigungen, ein neues Kodierungsprofil des Smartphones, sehr große Abmessungen, fehlende Decoder-Unterstützung, fehlgeschlagene Worker-Aufgaben, veraltete Miniaturansichtsdatensätze oder das clientseitige Laden des Originals nur den Pfad für abgeleitete Dateien beeinträchtigen. Untersuchen Sie ein einzelnes Asset – von den Originaldaten bis zur generierten Vorschau.

Bestätigen, dass die originale HEIC-Datei intakt ist

Laden Sie das Original aus der Galerie herunter und vergleichen Sie Größe und Hash mit dem Smartphone, Export oder Backup als Quelle. Öffnen Sie die Datei in einer vertrauenswürdigen Desktop-Anwendung, die HEIC unterstützt.

Immich-Nutzer haben von HEIC- und DNG-Uploads berichtet, nach denen keine Miniaturansichten und Vorschauen mehr generiert wurden. Daher ist es wichtig, ein beschädigtes Original von einer fehlgeschlagenen Pipeline für abgeleitete Dateien zu unterscheiden. Das sichtbare Symptom waren fehlende Miniaturansichten nach dem Upload.

Wenn das heruntergeladene Original unvollständig oder beschädigt ist, beheben Sie den Übertragungsweg und laden Sie die Datei aus einer verifizierten Quelle erneut hoch. Wenn sich das Original korrekt öffnen lässt, bewahren Sie es auf und fahren Sie mit Prüfungen von Metadaten, Decodierung und Aufgabenebene fort.

Metadaten funktionierender und fehlerhafter HEIC-Dateien vergleichen

Wählen Sie eine HEIC-Datei, für die Vorschauen generiert werden, und eine, bei der dies nicht geschieht. Vergleichen Sie Gerätemodell, Betriebssystemversion, Abmessungen, Farbtiefe, Farbprofil, zusätzliche Bilder, Ausrichtung, HDR-Metadaten, Dateigröße und Container-Kennungen.

Neue Smartphone-Software kann ein Profil einführen, das der aktuelle Server-Decoder nicht versteht. In einem Immich-Problem wurde festgestellt, dass HEIC-Dateien von iOS 18 die Generierung von Miniaturansichten mit Meldungen zu fehlerhaften Headern verhinderten, während ältere iOS-Bilder weiterhin funktionierten. Dadurch wurde ein neues Quellprofil unterschieden.

Testen Sie ein weiteres Foto desselben Smartphones erst nach einer Änderung der Kameraeinstellung, um den Fehler einzuordnen. Konvertieren oder überschreiben Sie die ursprüngliche Bibliothek nicht, bevor das inkompatible Profil und die Serverversion bekannt sind.

Bildabmessungen und Ressourcenlimits prüfen

Notieren Sie Breite, Höhe, Megapixel, Dateigröße und eingebettete zusätzliche Bilder der fehlerhaften Datei. Sehr große HEIC-Dateien können beim Decodieren erheblich mehr Arbeitsspeicher benötigen, als ihre komprimierte Dateigröße vermuten lässt.

Immich hat große HEIC-Dateien mit 200 Megapixeln dokumentiert, für die keine Miniaturansichten erstellt und keine Vorschauen angezeigt werden konnten. Die praktische Grenze waren extrem große HEIC-Abmessungen, nicht die gewöhnliche Galerienutzung.

Überwachen Sie Arbeitsspeicher, CPU, Containerlimits und Out-of-Memory-Ereignisse des Miniaturansichts-Workers, während eine einzelne Datei verarbeitet wird. Wenn kleinere HEIC-Bilder funktionieren, erhöhen Sie die verfügbaren Ressourcen des Workers oder behalten Sie eine kompatible Vorschaukopie, ohne das Original in voller Auflösung zu verwerfen.

Featured

ZimaCube 2 Persönliche Cloud Home NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

Den ersten Decodierungsfehler des Miniaturansichts-Workers auslesen

Starten Sie den Auftrag für fehlende Miniaturansichten oder die Regenerierung für ein betroffenes Asset und verfolgen Sie das Protokoll des Microservices oder Workers. Erfassen Sie den ersten Fehler bei Decoder, Header, Farbraum, Berechtigungen oder beim Schreiben – nicht den abschließenden allgemeinen Fehler.

Aktuelle Immich-Berichte zeigen weiterhin, dass die Generierung von Miniaturansichten für bestimmte HEIC-Dateien nach Aktualisierungen fehlschlägt. Ein Problem aus dem Jahr 2026 beschreibt einen durch eine Aktualisierung verursachten Fehler bei der HEIC-Verarbeitung.

Wenn nach dem ersten HEIC-Fehler jede neue Datei fehlschlägt, starten Sie nur den betroffenen Worker neu, nachdem Sie die Protokolle gesichert haben, und prüfen Sie den Zustand der Warteschlange. Ein einzelnes fehlerhaftes Asset darf nicht verschleiern, ob der Worker-Prozess selbst die Generierung aller späteren Vorschauen eingestellt hat.

Decoder-Bibliotheken und Versionskompatibilität überprüfen

Notieren Sie Galerieversion, Container-Image, Bildverarbeitungsbibliothek, HEIF-Decoder, CPU-Architektur und ob sich beim Update hardwarespezifische Builds geändert haben. Vergleichen Sie diese Angaben mit der letzten bekannten funktionierenden Bereitstellung.

Einige HEIC-Fehler betreffen auch innerhalb derselben Serverversion nur einen Teil der Bilder. Ein Immich-Problem berichtet, dass nur bestimmte HEIC-Dateien fehlschlugen. Das deutet auf eine Grenze bei einem Formatmerkmal und nicht auf das vollständige Fehlen von HEIC-Unterstützung hin.

Testen Sie dasselbe Original mit der vorherigen Anwendungsversion oder einem isolierten Worker-Image der aktuellen Version. Führen Sie ein Rollback nur aus einer konsistenten Sicherung von Datenbank und Konfiguration durch. Setzen Sie die Produktionsdatenbank nicht blind zurück, nur um einen Bilddecoder zu testen.

Serverfehler bei Vorschauen vom Laden des Originals durch den Client unterscheiden

Öffnen Sie das betroffene Asset im Web-Client, in der mobilen App und in einer privaten Browsersitzung. Notieren Sie getrennt, ob die Miniaturansicht in der Zeitleiste, die mittlere Vorschau, das abgeleitete Bild in voller Größe und der Download des Originals fehlschlagen.

Ein Browser kann die Anzeige des HEIC-Originals verweigern, während eine generierte Vorschau weiterhin funktionieren sollte. Ein Immich-Problem mit Safari beschreibt, dass das Laden des originalen HEIC fehlschlug, obwohl der Client auf eine Vorschau oder ein abgeleitetes Bild in voller Größe zurückgreifen konnte.

Wenn nur ein Client fehlschlägt, löschen Sie die zwischengespeicherte Asset-Antwort dieses Clients und vergleichen Sie die Einstellungen zum Laden des Originals. Wenn bei allen Clients die Miniaturansicht fehlt und das Worker-Protokoll keine generierte Datei ausweist, konzentrieren Sie die Diagnose weiterhin auf die Serverseite.

Nach der Behebung nur fehlende abgeleitete Dateien neu generieren

Sichern Sie Datenbank und Metadatenvolume und führen Sie anschließend den Auftrag für fehlende Miniaturansichten für eine kleine betroffene Auswahl aus. Bestätigen Sie, dass neue abgeleitete Dateien erstellt werden, ohne die Originale zu ersetzen.

Immich-Versionen haben Nutzern mit beschädigten Miniaturansichten empfohlen, nach relevanten Korrekturen den Auftrag für fehlende Miniaturansichten auszuführen. Das spricht für eine gezielte Regenerierung nach der Reparatur, statt zuerst den gesamten Speicher für Miniaturansichten zu löschen.

Der ZimaSpace-Leitfaden zur privaten iPhone-Fotosicherung beschreibt die grundlegende Voraussetzung: Bewahren und überprüfen Sie Originalfotos unabhängig von den Galerie-Vorschauen.

Das Problem ist behoben, wenn der Hash des Originals unverändert bleibt, der Worker für das fehlerhafte HEIC-Profil Miniaturansichten generiert, alle unterstützten Clients das abgeleitete Bild laden und ein neues Foto desselben Smartphones korrekt verarbeitet wird, ohne die gesamte Bibliothek neu aufzubauen.