Waardoor verliezen HEIC-foto's hun voorbeeldweergave in een zelfgehoste galerij?

Voorvertoningen van HEIC-bestanden verdwijnen wanneer de galerij het origineel niet kan decoderen, de afgeleide afbeelding niet kan genereren of die afgeleide afbeelding niet aan de huidige client kan leveren.

Een zelfgehoste galerij bewaart het HEIC-origineel normaal gesproken en maakt JPEG- of WebP-miniaturen en voorvertoningen voor browsers en telefoons die mogelijk niet elk HEIF-profiel rechtstreeks kunnen weergeven. Het origineel kan downloadbaar blijven terwijl de tijdlijn leeg is, omdat beschadiging, een nieuw coderingsprofiel van de telefoon, zeer grote afmetingen, ontbrekende decoderondersteuning, mislukte worker-taken, verouderde miniatuurrecords of het laden van het origineel aan de clientzijde alleen het pad van de afgeleide afbeelding beïnvloeden. Diagnoseer één bestand, van de originele bytes tot de gegenereerde voorvertoning.

Controleer of het originele HEIC-bestand intact is

Download het origineel uit de galerij en vergelijk de grootte en hash ervan met die van de brontelefoon, export of back-up. Open het in een betrouwbare desktoptoepassing die HEIC ondersteunt.

Immich-gebruikers hebben gemeld dat na het uploaden van HEIC- en DNG-bestanden geen miniaturen en voorvertoningen meer werden gegenereerd. Daarom is het belangrijk om een beschadigd origineel te onderscheiden van een mislukte pijplijn voor afgeleide afbeeldingen. Het zichtbare symptoom was ontbrekende miniaturen na het uploaden.

Als het gedownloade origineel afgekapt of beschadigd is, herstel dan het overdrachtspad en upload het opnieuw vanuit een geverifieerde bron. Als het origineel correct wordt geopend, bewaar het dan en ga verder met controles op metagegevens, decoders en taken.

Vergelijk metagegevens van werkende en falende HEIC-bestanden

Kies één HEIC-bestand waarvoor wel voorvertoningen worden gegenereerd en één waarvoor dat niet gebeurt. Vergelijk het apparaatmodel, de versie van het besturingssysteem, de afmetingen, bitdiepte, het kleurprofiel, aanvullende afbeeldingen, de oriëntatie, HDR-metagegevens, bestandsgrootte en containermerken.

Nieuwe telefoonsoftware kan een profiel introduceren dat de huidige serverdecoder niet begrijpt. In een Immich-issue bleken HEIC-bestanden van iOS 18 geen miniaturen te kunnen genereren door meldingen over onjuiste headers, terwijl oudere iOS-afbeeldingen nog wel werkten. Daarmee werd een nieuw verschil in het bronprofiel geïsoleerd.

Test nog een foto van dezelfde telefoon nadat je alleen een camera-instelling hebt gewijzigd, uitsluitend om de oorzaak te classificeren. Converteer de oorspronkelijke bibliotheek niet en overschrijf deze niet voordat het incompatibele profiel en de serverversie bekend zijn.

Controleer afbeeldingsafmetingen en resourcebeperkingen

Noteer de breedte, hoogte, het aantal megapixels, de bestandsgrootte en de ingesloten aanvullende afbeeldingen van de falende afbeelding. Voor het decoderen van zeer grote HEIC-bestanden kan aanzienlijk meer geheugen nodig zijn dan hun gecomprimeerde bestandsgrootte doet vermoeden.

Immich heeft grote HEIC-bestanden van 200 megapixels gedocumenteerd waarvoor geen miniaturen of voorvertoningen konden worden gemaakt. De praktische grens lag bij extreem grote HEIC-afmetingen, niet bij normaal browsen door de galerij.

Houd tijdens het verwerken van één bestand het geheugen- en CPU-gebruik van de miniaturen-worker, de containerlimieten en out-of-memory-gebeurtenissen in de gaten. Als kleinere HEIC-afbeeldingen wel werken, verhoog dan de beschikbare resources voor de worker of bewaar een compatibele kopie voor voorvertoningen zonder het origineel met volledige resolutie weg te gooien.

Featured

ZimaCube 2 Persoonlijke Cloud Home NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

Lees de eerste decodeerfout van de miniaturen-worker

Voer de taak voor ontbrekende miniaturen of opnieuw genereren uit voor één getroffen item en volg het logboek van de microservice of worker. Leg de eerste decoder-, header-, kleurruimte-, rechten- of schrijffout vast in plaats van de uiteindelijke algemene foutmelding.

Recente meldingen over Immich laten nog steeds zien dat het genereren van miniaturen voor specifieke HEIC-bestanden na upgrades kan mislukken. Een issue uit 2026 beschrijft een HEIC-verwerkingsfout die met een upgrade samenhing.

Als elk nieuw bestand na de eerste HEIC-fout mislukt, start dan alleen de falende worker opnieuw nadat je de logboeken hebt bewaard en controleer je de status van de wachtrij. Eén verminkt bestand mag niet verhullen of het workerproces zelf alle volgende voorvertoningen niet meer genereert.

Controleer decoderbibliotheken en versiecompatibiliteit

Noteer de galerijversie, containerimage, beeldverwerkingsbibliotheek, HEIF-decoder, CPU-architectuur en of er tijdens de update hardware-specifieke builds zijn gewijzigd. Vergelijk deze gegevens met de laatst bekende goed werkende implementatie.

Sommige HEIC-fouten treffen slechts een deel van de afbeeldingen, zelfs binnen één serverversie. Een Immich-issue meldt dat alleen bepaalde HEIC-bestanden faalden, wat wijst op een grens in de formaatfuncties en niet op een volledig ontbrekende HEIC-ondersteuning.

Test hetzelfde origineel met de vorige applicatieversie of met een geïsoleerde huidige workerimage. Zet alleen terug vanuit een consistente back-up van de database en configuratie; downgrade de productiedatabase niet blindelings om een afbeeldingsdecoder te testen.

Scheid een serverfout met voorvertoningen van het laden van het origineel door de client

Open het getroffen item in de webclient, mobiele app en een privésessie van de browser. Noteer afzonderlijk of de miniatuur in de tijdlijn, de middelgrote voorvertoning, de afgeleide afbeelding op volledige grootte en de download van het origineel mislukken.

Een browser kan het originele HEIC-bestand mogelijk niet weergeven, terwijl een gegenereerde voorvertoning wel zou moeten werken. Een Immich-issue over Safari beschrijft dat het laden van het originele HEIC-bestand mislukte, hoewel de client kon terugvallen op een voorvertoning of afgeleide afbeelding op volledige grootte.

Als slechts één client faalt, wis dan de gecachte reactie van die client en vergelijk de instellingen voor het laden van originelen. Als geen enkele client de miniatuur kan laden en het workerlogboek geen gegenereerd bestand toont, richt de diagnose dan op de server.

Genereer alleen ontbrekende afgeleide afbeeldingen opnieuw nadat de oorzaak is opgelost

Maak een back-up van de database en het metagegevensvolume en voer vervolgens de taak voor ontbrekende miniaturen uit voor een kleine getroffen set. Controleer of er nieuwe afgeleide afbeeldingen worden gemaakt zonder de originelen te vervangen.

Immich-releases hebben gebruikers met defecte miniaturen verwezen naar de taak voor ontbrekende miniaturen nadat relevante oplossingen waren uitgebracht. Dit ondersteunt gerichte regeneratie na herstel in plaats van eerst de volledige miniatuuropslag te verwijderen.

De ZimaSpace-gids voor privéback-ups van iPhone-foto's beschrijft de bredere vereiste: bewaar en verifieer originele foto's onafhankelijk van galerijvoorvertoningen.

Het probleem is opgelost wanneer de hash van het origineel ongewijzigd blijft, de worker miniaturen genereert voor het falende HEIC-profiel, alle ondersteunde clients de afgeleide afbeelding kunnen laden en een nieuwe foto van dezelfde telefoon correct wordt verwerkt zonder de volledige bibliotheek opnieuw op te bouwen.