Testa un file RAW con lo stesso decodificatore al di fuori della coda, quindi confronta l'assegnazione del worker e i log del job per distinguere il mancato supporto al formato da un errore di esecuzione.
La decisione è importante quando i file RAW originali vengono importati correttamente, ma le anteprime rimangono vuote o in attesa. I due stati contrapposti sono la decodifica RAW non supportata o non riuscita e un errore della coda delle miniature, del worker, dei permessi o dello spazio di archiviazione di output. Inizia con una configurazione salvata e dati eliminabili, osserva un solo ramo alla volta e fermati se il test aumenta il rischio di perdita di dati, problemi di autorizzazioni o indisponibilità.
Distinguere la decodifica RAW non supportata o non riuscita dagli errori della coda delle miniature, del worker, dei permessi o dello spazio di archiviazione di output
Registra l'ambiente prima di modificare qualsiasi cosa: versioni del software e del firmware, identità dei dispositivi, percorso di montaggio o di rete, spazio libero, permessi e sintomo osservabile. La baseline deve conservare dettagli sufficienti per riprodurre la situazione in cui i file RAW originali vengono importati correttamente, ma le anteprime rimangono vuote o in attesa.
Il primo candidato è la decodifica RAW non supportata o non riuscita. Il secondo è un errore della coda delle miniature, del worker, dei permessi o dello spazio di archiviazione di output. Gli attuali tipi di media supportati da Immich definiscono il meccanismo o il confine del comando utilizzato nel test; non sostituiscono le osservazioni effettuate su questo specifico server domestico.
Scrivi la condizione di accettazione e quella di arresto prima di eseguire il discriminatore. Un esito positivo deve modificare le prove previste da un ramo lasciando invariati i servizi non correlati; un esito negativo deve riportare il sistema allo stato salvato invece di avviare una catena di correzioni speculative.
Eseguire un solo discriminatore controllato
Usa questo discriminatore: esegui i test dei metadati e della decodifica su un solo RAW copiato, accoda un solo job per la miniatura e seguilo dalla coda al file di output. Mantieni costanti carico di lavoro, client, percorso, insieme di file e tempistiche, così che il risultato sia attribuibile alla variabile modificata.
Usa il supporto dei decodificatori libvips per selezionare il campo in grado di distinguere effettivamente i rami, quindi acquisisci il relativo timestamp, codice di uscita, testo dell'errore, identità del dispositivo o dello snapshot, latenza, byte trasferiti, permessi e stato di ripristino. Un'uscita pulita del comando non è sufficiente quando l'ipotesi in esame riguarda identità, durabilità o stato dell'applicazione.
Ripeti il test una volta dopo un riavvio, una riconnessione, un nuovo montaggio o una cache fredda quando tale evento fa parte della condizione originale. Se la prima esecuzione è distruttiva o l'ambiente non può essere ripristinato, fermati e riproduci il test su una copia eliminabile.
exiftool sample.CR3
# Decodifica una copia con lo stack di immagini installato, quindi accoda un solo job per la miniatura
Interpretare quale ramo è supportato dalle prove
ESITO POSITIVO: il decodificatore non riesce prima dell'elaborazione della coda oppure la decodifica riesce, ma il worker non scrive mai il derivato. Registra la versione, l'identità e il carico di lavoro esatti che hanno prodotto l'esito positivo, così la conclusione rimane condizionata invece di diventare un'affermazione universale.
ESITO NEGATIVO: non funziona solo una fotocamera o una modalità di compressione, quindi il supporto deve essere circoscritto a quel campione. Un esito negativo non dimostra automaticamente il ramo opposto quando rete, memoria, permessi o coerenza della sorgente possono influire su entrambi; isola queste dipendenze condivise prima di procedere.
RISULTATO ECCEZIONALE O AMBIGUO: conserva gli originali, arresta le raffiche di tentativi e mantieni un percorso funzionante per le anteprime JPEG durante l'indagine. Conserva i log e non eseguire comandi di riparazione, pulizia, eliminazione, ripartizionamento o modifica ricorsiva della proprietà finché non esiste una copia ripristinabile.
Applicare l'azione corrispondente e riprodurre l'errore originale
Applica l'azione corrispondente al ramo osservato, quindi ripeti la condizione originale invece di una versione ridotta. La decisione è valida solo quando il decodificatore non riesce prima dell'elaborazione della coda oppure la decodifica riesce, ma il worker non scrive mai il derivato per due cicli o durante il riavvio, la sospensione, l'interruzione o la transizione di carico pertinente.
Usa le librerie Immich in sola lettura per controllare il flusso di lavoro dipendente più vicino, ma mantieni invariato il trigger originale. Set di dati, condivisioni, container, utenti e punti di ripristino non correlati devono conservare l'accesso e le tempistiche precedenti.
Il limite di arresto è esplicito: se non funziona solo una fotocamera o una modalità di compressione, quindi il supporto deve essere circoscritto a quel campione, torna all'ultima configurazione verificata, conserva le prove e procedi a un test più approfondito della piattaforma o dell'hardware solo quando il ramo è ripetibile.
Dopo aver ottenuto il risultato previsto, confrontalo con la pianificazione dei job delle miniature, così che la correzione non trasferisca il rischio a un servizio vicino. Un test mirato riuscito con un nuovo errore di backup, identità, timeout o disponibilità è comunque una modifica non riuscita.
Domande frequenti
Per diagnosticare l'anteprima RAW mancante, le ricerche rimanenti riguardano di solito il motivo per cui alcuni file RAW della stessa fotocamera funzionano, se i permessi dei file possano sembrare corretti ma i worker continuino a non riuscire e se sia necessario rigenerare le anteprime per l'intera libreria. Le risposte seguenti mantengono questi casi limite separati dalla decisione principale.
Il limite di accettazione non cambia: il decodificatore non riesce prima dell'elaborazione della coda oppure la decodifica riesce, ma il worker non scrive mai il derivato. Se una condizione successiva modifica il filesystem, l'identità, il percorso di rete o la versione dell'applicazione, ripeti solo il discriminatore interessato da tale modifica.
Smetti di ampliare l'esperimento quando non funziona solo una fotocamera o una modalità di compressione, quindi il supporto deve essere circoscritto a quel campione. A quel punto, conserva gli originali, arresta le raffiche di tentativi e mantieni un percorso funzionante per le anteprime JPEG durante l'indagine; conserva le prove prima di coinvolgere il responsabile della piattaforma, dello storage o dell'hardware.
Perché funzionano alcuni file RAW della stessa fotocamera?
Il firmware della fotocamera, la modalità di compressione, l'anteprima incorporata e la versione del decodificatore possono differire anche all'interno della stessa estensione.
I permessi dei file possono sembrare corretti, ma i worker continuare a non funzionare?
Sì. Il worker potrebbe usare un percorso del container, un UID o un montaggio di output diverso.
È necessario rigenerare le anteprime per l'intera libreria?
Non prima che un campione abbia esito positivo e che la coda e lo spazio disponibile possano assorbire il carico.
La diagnosi è conclusa quando lo stesso carico di lavoro fa sì che le prove seguano il ramo della decodifica RAW non supportata o non riuscita oppure quello dell'errore della coda delle miniature, del worker, dei permessi o dello spazio di archiviazione di output, e l'azione corrispondente rimuove il sintomo originale senza crearne un secondo. Se nessuno dei due rami rimane ripetibile, mantieni intatti i log e lo stato salvato; l'incertezza è un motivo per procedere all'escalation, non per accumulare altre correzioni.
Supporto e consigli
Altro da leggere

Guida all’archiviazione delle registrazioni TV in diretta per capacità, conservazione e pulizia
Misura le registrazioni reali, riserva margine, combina i limiti di età e capacità e dimostra che il programma idoneo più vecchio viene rimosso prima...

Procedura di recupero dei metadati multimediali domestici dopo il ripristino di un database
Proteggi lo stato ripristinato, verifica l'identità e i percorsi dei media, quindi correggi le copertine o le corrispondenze mancanti in una libreria pilota prima...

Checklist di compatibilità del client Jellyfin per audio, video e sottotitoli
Testa file rappresentativi una variabile alla volta e registra Direct Play, remux, conversione audio, transcodifica video o errore per ogni client.

