Vad gör att HEIC-foton förlorar förhandsvisningar i ett självvärdsgalleri?
HEIC-förhandsvisningar försvinner när galleriet inte kan avkoda originalet, skapa dess härledda bild eller leverera den härledda bilden till den aktuella klienten.
Ett självhostat galleri bevarar normalt HEIC-originalet samtidigt som det skapar JPEG- eller WebP-miniatyrer och förhandsvisningar för webbläsare och telefoner som kanske inte kan visa alla HEIF-profiler direkt. Originalet kan fortfarande vara nedladdningsbart även när tidslinjen är tom, eftersom korruption, en ny kodningsprofil från telefonen, mycket stora dimensioner, saknat avkodarstöd, misslyckade arbetarjobb, inaktuella miniatyrposter eller klientens inläsning av originalet endast påverkar den härledda bildens sökväg. Diagnostisera en tillgång från originalets byte till den genererade förhandsvisningen.
Bekräfta om den ursprungliga HEIC-filen är intakt
Ladda ner originalet från galleriet och jämför dess storlek och hash med källtelefonen, exporten eller säkerhetskopian. Öppna den i ett pålitligt datorprogram som stöder HEIC.
Immich-användare har rapporterat HEIC- och DNG-uppladdningar efter vilka miniatyrer och förhandsvisningar slutade genereras, vilket gör det viktigt att skilja ett skadat original från en misslyckad pipeline för härledda bilder. Det synliga symptomet var saknade miniatyrer efter uppladdning.
Om det nedladdade originalet är avkortat eller skadat reparerar du överföringssökvägen och laddar upp filen igen från en verifierad källa. Om originalet öppnas korrekt bevarar du det och fortsätter med kontroller av metadata, avkodare och jobb.
Jämför metadata för fungerande och felande HEIC-filer
Välj en HEIC-fil som genererar förhandsvisningar och en som inte gör det. Jämför enhetsmodell, operativsystemsversion, dimensioner, bitdjup, färgprofil, hjälpbilder, orientering, HDR-metadata, filstorlek och behållarens varumärken.
Ny programvara i telefonen kan introducera en profil som den aktuella serveravkodaren inte förstår. Ett Immich-ärende visade att HEIC-filer från iOS 18 inte kunde generera miniatyrer och gav meddelanden om felaktiga rubriker, medan äldre iOS-bilder fortfarande fungerade. Det isolerade en ny skillnad i källprofilen.
Testa ett annat foto från samma telefon efter en ändring av kamerainställningen, endast för att klassificera felet. Konvertera inte och skriv inte över originalbiblioteket innan den inkompatibla profilen och serverversionen är kända.
Kontrollera bilddimensioner och resursgränser
Notera den felande bildens bredd, höjd, megapixlar, filstorlek och inbäddade hjälpbilder. Mycket stora HEIC-filer kan kräva betydligt mer minne under avkodning än vad deras komprimerade filstorlek antyder.
Immich har dokumenterat stora HEIC-filer på 200 megapixlar som inte kunde skapa miniatyrer eller visa förhandsvisningar. Den praktiska gränsen var extremt stora HEIC-dimensioner, inte vanlig gallerianvändning.
Övervaka miniatyrarbetarens minne, processor, containergränser och minnesbrist-händelser medan du bearbetar en fil. Om mindre HEIC-bilder fungerar kan du öka de stödda resurserna för arbetaren eller behålla en kompatibel förhandsvisningskopia utan att kasta bort originalet i full upplösning.
Läs det första avkodningsfelet från miniatyrarbetaren
Kör jobbet för saknade miniatyrer eller återskapande för en berörd tillgång och följ mikroservice- eller arbetarloggen. Fånga det första felet för avkodare, rubrik, färgrymd, behörighet eller skrivning i stället för det slutliga generiska felet.
Nya Immich-rapporter visar fortfarande att miniatyrgenerering misslyckas för specifika HEIC-filer efter uppgraderingar. Ett ärende från 2026 identifierar ett HEIC-bearbetningsfel kopplat till en uppgradering.
Om varje ny fil misslyckas efter det första HEIC-felet startar du endast om den felande arbetaren efter att ha sparat loggarna och verifierar köstatusen. En enskild felaktig tillgång ska inte få dölja om själva arbetarprocessen har slutat generera alla efterföljande förhandsvisningar.
Verifiera avkodningsbibliotek och versionskompatibilitet
Notera galleriets version, containeravbild, bildbehandlingsbibliotek, HEIF-avkodare, processorarkitektur och om maskinvaruspecifika byggen ändrades under uppdateringen. Jämför dem med den senaste driftsättningen som fungerade.
Vissa HEIC-fel påverkar endast ett urval av bilder, även inom samma serverversion. Ett Immich-ärende rapporterar att endast vissa HEIC-filer misslyckades, vilket tyder på en gräns för ett formatfunktion snarare än total avsaknad av HEIC-stöd.
Testa samma original med den tidigare programversionen eller en isolerad aktuell arbetaravbild. Rulla endast tillbaka från en konsekvent säkerhetskopia av databas och konfiguration. Nedgradera inte produktionsdatabasen blint för att testa en bildavkodare.
Skilj serverfel i förhandsvisningen från klientens inläsning av originalet
Öppna den berörda tillgången i webbklienten, mobilappen och en privat webbläsarsession. Notera om tidslinjens miniatyr, medelstor förhandsvisning, härledda bild i full storlek och nedladdning av originalet misslyckas oberoende av varandra.
En webbläsare kan misslyckas med att visa det ursprungliga HEIC-originalet medan en genererad förhandsvisning ändå borde fungera. Ett Immich-ärende för Safari beskriver att inläsning av det ursprungliga HEIC-originalet misslyckades, även om klienten kunde falla tillbaka till en förhandsvisning eller en härledd bild i full storlek.
Om endast en klient misslyckas rensar du klientens cachade tillgångssvar och jämför inställningarna för inläsning av original. Om ingen klient har miniatyren och arbetarloggen inte visar någon genererad fil håller du felsökningen på serversidan.
Återskapa endast saknade härledda bilder när orsaken är åtgärdad
Säkerhetskopiera databasen och metadatavolymen och kör sedan programmets jobb för saknade miniatyrer på ett litet antal berörda tillgångar. Bekräfta att nya härledda bilder skapas utan att originalen ersätts.
Immich-versioner har hänvisat användare med trasiga miniatyrer till att köra jobbet för saknade miniatyrer efter relevanta korrigeringar, vilket stöder riktad återskapning efter reparation i stället för att först radera hela miniatyrlagret.
ZimaSpaces guide till privat säkerhetskopiering av iPhone-foton beskriver det övergripande kravet: bevara och verifiera originalfoton oberoende av galleriets förhandsvisningar.
Problemet är löst när originalets hash förblir oförändrad, arbetaren genererar miniatyrer för den felande HEIC-profilen, alla stödda klienter läser in den härledda bilden och ett nytt foto från samma telefon bearbetas korrekt utan att hela biblioteket behöver byggas om.
Rekommenderade produkter
Support och tips
Mer att läsa
Varför återskapar en återställning av en Docker-volym filinnehållet men tar bort utökade attribut?
En felsökning av volymåterställning som omfattar inventering av xattr, alternativ för tar och Rsync, namnrymder, stöd för måldestinationen, behörigheter, etiketter, appmetadata och tester.
Varför behåller en körande container sin gamla minnesgräns efter att Compose-filen har ändrats?
En minnesgränsdiagnos som omfattar aktiva cgroups, omstart kontra återskapande, Compose-fält, hårda och mjuka gränser, överordnade scope, växlingsutrymme och körningsheapar.
Varför ogiltigförklarar en omstart av en omvänd proxy varje session för en självhostad app?
En sessionsförlustdiagnos som omfattar omstartens omfattning, cookie-ägarskap, rotation av hemligheter, cachebaserade sessioner, sticky routing, autentiseringsgatewayer och återställning.
