Avkodningsfel eller fel i miniatyrbildsarbetaren? Testar saknade RAW-förhandsvisningar

Eva Wong är Teknisk skribent och den boende fixaren på ZimaSpace. En livslång nörd med en passion för hemma-labb och öppen källkod, hon specialiserar sig på att översätta komplexa tekniska koncept till tillgängliga, praktiska guider. Eva tror att självhosting ska vara roligt, inte skrämmande. Genom sina handledningar ger hon gemenskapen verktyg att avmystifiera hårdvaruinstallationer, från att bygga sin första NAS till att bemästra Docker-containrar.

Testa en RAW-fil med samma avkodare utanför kön och jämför sedan tilldelningen av arbetare och jobbloggar för att skilja formatstöd från körningsfel.

Beslutet är viktigt när ursprungliga RAW-filer importeras korrekt men förhandsvisningarna förblir tomma eller väntande. De två konkurrerande tillstånden är avkodning av RAW som inte stöds eller misslyckas, samt fel i miniatyrbildskö, arbetare, behörigheter eller utdata. Börja med en sparad konfiguration och data som kan kastas, observera en gren i taget och avbryt om testet ökar risken för dataförlust, behörighetsproblem eller otillgänglighet.

Skilj avkodning av RAW som inte stöds eller misslyckas från fel i miniatyrbildskö, arbetare, behörigheter eller utdata

Dokumentera miljön innan du ändrar något: programvaru- och firmwareversioner, enhetsidentiteter, monteringssökväg eller nätverkssökväg, ledigt utrymme, behörigheter och det observerbara symptomet. Baslinjen måste innehålla tillräckligt med information för att återskapa att ursprungliga RAW-filer importeras korrekt men att förhandsvisningarna förblir tomma eller väntande.

Den första kandidaten är avkodning av RAW som inte stöds eller misslyckas. Den andra är fel i miniatyrbildskö, arbetare, behörigheter eller utdata. Aktuella medietyper som stöds av Immich definierar den mekanism eller kommandogräns som används i testet; de ersätter inte observationer från just den här hemservern.

Skriv ned godkännandekriteriet och stoppkriteriet innan du kör skiljetestet. Ett godkänt resultat måste ändra de bevis som förutsägs av en gren utan att påverka orelaterade tjänster; ett underkänt resultat måste återställa systemet till det sparade tillståndet i stället för att utlösa en kedja av spekulativa åtgärder.

Kör ett kontrollerat skiljetest

Använd detta skiljetest: kör metadata- och avkodningssonder på en kopierad RAW-fil, lägg ett miniatyrbildsjobb i kön och följ det från kön till utdatafil. Håll arbetsbelastning, klient, sökväg, filuppsättning och tidsinställning konstanta så att resultatet kan hänföras till den ändrade variabeln.

Använd libvips-avkodningsstöd för att välja det fält som faktiskt kan skilja grenarna åt och fånga dess tidsstämpel, avslutningsstatus, feltext, enhets- eller ögonblicksbildsidentitet, fördröjning, överförda byte, behörigheter och återställningstillstånd. En ren kommandoavslutning räcker inte när identitet, beständighet eller programtillstånd är det som testas.

Upprepa testet en gång efter en omstart, återanslutning, ominstallering eller tom cache när den händelsen ingår i det ursprungliga tillståndet. Om den första körningen är destruktiv eller miljön inte kan återställas ska du avbryta och återskapa testet på en kopia som kan kastas.

exiftool sample.CR3
# Avkoda en kopia med den installerade bildstacken och lägg ett miniatyrbildsjobb i kön

Tolka vilken gren bevisen stöder

GODKÄNT: avkodaren misslyckas innan köarbetet börjar, eller så lyckas avkodningen medan arbetaren aldrig skriver den härledda filen. Dokumentera den exakta versionen, identiteten och arbetsbelastningen som godkändes så att slutsatsen förblir villkorad i stället för att bli ett universellt påstående.

UNDERKÄNT: endast en kamera eller ett komprimeringsläge misslyckas, så stödet måste avgränsas till det provet. Ett underkänt resultat bevisar inte automatiskt den motsatta grenen när nätverk, minne, behörigheter eller källans konsekvens kan påverka båda; isolera dessa gemensamma beroenden innan du eskalerar.

UNDANTAG ELLER TVETYDIGT RESULTAT: bevara originalen, stoppa stormar av nya försök och behåll en fungerande JPEG-förhandsvisning medan du utreder. Bevara loggarna och kör inte kommandon för reparation, rensning, förstöring, ompartitionering eller rekursivt ägarskap innan en återställningsbar kopia finns.

Tillämpa den matchade åtgärden och återskapa det ursprungliga felet

Tillämpa den åtgärd som motsvarar den observerade grenen och upprepa sedan det ursprungliga tillståndet i stället för en förenklad ersättning. Beslutet gäller endast när avkodaren misslyckas innan köarbetet börjar, eller när avkodningen lyckas medan arbetaren aldrig skriver den härledda filen under två cykler eller vid relevant omstart, viloläge, avbrott eller belastningsövergång.

Använd de skrivskyddade Immich-biblioteken för att kontrollera det närmaste beroende arbetsflödet, men behåll den ursprungliga utlösaren oförändrad. Orelaterade datauppsättningar, delningar, containrar, användare och återställningspunkter måste behålla sin tidigare åtkomst och tidsåtgång.

Stoppgränsen är tydlig: om endast en kamera eller ett komprimeringsläge misslyckas, så att stödet måste avgränsas till det provet, återgår du till den senast verifierade konfigurationen, behåller bevisen och eskalerar till ett djupare plattforms- eller hårdvarutest endast när grenen kan upprepas.

När målresultatet kvarstår jämför du det med schemaläggning av miniatyrbildsjobb så att lösningen inte flyttar risken till en närliggande tjänst. Ett lyckat måltest med ett nytt fel i säkerhetskopiering, identitet, tidsgräns eller tillgänglighet är fortfarande en misslyckad ändring.

Vanliga frågor

Vid felsökning av saknade RAW-förhandsvisningar brukar de återstående frågorna gälla varför vissa RAW-filer från en kamera fungerar, om filbehörigheterna kan se korrekta ut trots att arbetarna ändå misslyckas och om förhandsvisningar bör återskapas för hela biblioteket. Svaren nedan håller dessa specialfall åtskilda från huvudbeslutet.

Godkännandegränsen ändras inte: avkodaren misslyckas innan köarbetet börjar, eller så lyckas avkodningen medan arbetaren aldrig skriver den härledda filen. Om ett uppföljande tillstånd ändrar filsystemet, identiteten, nätverkssökvägen eller programversionen ska du upprepa endast det skiljetest som påverkas av ändringen.

Sluta bredda experimentet när endast en kamera eller ett komprimeringsläge misslyckas, så att stödet måste avgränsas till det provet. Bevara då originalen, stoppa stormar av nya försök och behåll en fungerande JPEG-förhandsvisning medan du utreder; bevara bevisen innan du eskalerar till plattforms-, lagrings- eller hårdvaruansvarig.

Varför fungerar vissa RAW-filer från en kamera?

Kamerans firmware, komprimeringsläge, inbäddade förhandsvisning och avkodarversion kan skilja sig trots samma filändelse.

Kan filbehörigheterna se korrekta ut trots att arbetarna ändå misslyckas?

Ja. Arbetaren kan använda en annan containersökväg, UID eller utdataenhet.

Bör förhandsvisningar återskapas för hela biblioteket?

Inte förrän ett prov lyckas och kö- samt lagringsutrymmet har kapacitet för arbetet.

Diagnosen är färdig när samma arbetsbelastning gör att bevisen följer antingen avkodning av RAW som inte stöds eller misslyckas eller fel i miniatyrbildskö, arbetare, behörigheter eller utdata, och den matchade åtgärden tar bort det ursprungliga symptomet utan att skapa ett nytt. Om ingen av grenarna förblir reproducerbar ska du behålla loggarna och det sparade tillståndet intakta; osäkerhet är ett skäl att eskalera, inte att stapla fler åtgärder.

Support och tips

Mer att läsa

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.