Teste um ficheiro RAW com o mesmo descodificador fora da fila e, em seguida, compare a atribuição do trabalhador e os registos do trabalho para distinguir entre falta de suporte ao formato e falha de execução.
A decisão é importante quando os ficheiros RAW originais são importados com sucesso, mas as pré-visualizações permanecem vazias ou pendentes. Os dois estados concorrentes são a descodificação RAW não suportada ou com falhas e uma falha na fila de miniaturas, no trabalhador, nas permissões ou no armazenamento de saída. Comece com uma configuração guardada e dados descartáveis, observe um ramo de cada vez e pare se o teste aumentar o risco de perda de dados, de permissões ou de disponibilidade.
Separe a descodificação RAW não suportada ou com falhas da falha na fila de miniaturas, no trabalhador, nas permissões ou no armazenamento de saída
Registe o ambiente antes de alterar qualquer coisa: versões do software e do firmware, identidades dos dispositivos, caminho de montagem ou de rede, espaço livre, permissões e o sintoma observável. A linha de base deve preservar detalhes suficientes para reproduzir a situação em que os ficheiros RAW originais são importados com sucesso, mas as pré-visualizações permanecem vazias ou pendentes.
O primeiro candidato é a descodificação RAW não suportada ou com falhas. O segundo é uma falha na fila de miniaturas, no trabalhador, nas permissões ou no armazenamento de saída. Os tipos de multimédia suportados pelo Immich atuais definem o mecanismo ou limite de comando utilizado no teste; não substituem a observação deste servidor doméstico específico.
Escreva a condição de aceitação e a condição de paragem antes de executar o teste discriminador. Um resultado aprovado deve alterar as evidências previstas por um ramo, mantendo os serviços não relacionados inalterados; um resultado reprovado deve devolver o sistema ao estado guardado, em vez de desencadear uma cadeia de correções especulativas.
Execute um único teste discriminador controlado
Utilize este teste discriminador: execute sondas de metadados e de descodificação num único RAW copiado, coloque um trabalho de miniatura na fila e acompanhe-o desde a fila até ao ficheiro de saída. Mantenha constantes a carga de trabalho, o cliente, o caminho, o conjunto de ficheiros e o momento da execução, para que o resultado possa ser atribuído à variável alterada.
Utilize o suporte de descodificação do libvips para selecionar o campo que pode efetivamente separar os ramos e, em seguida, capture o respetivo carimbo de data/hora, estado de saída, texto do erro, identidade do dispositivo ou do instantâneo, latência, bytes transferidos, permissões e estado de recuperação. Uma saída limpa do comando não é suficiente quando a identidade, a durabilidade ou o estado da aplicação são a afirmação em teste.
Repita o teste uma vez após um reinício, uma nova ligação, uma remontagem ou uma cache fria quando esse evento fizer parte da condição original. Se a primeira execução for destrutiva ou se o ambiente não puder ser restaurado, pare e reproduza-a numa cópia descartável.
exiftool sample.CR3
# Descodifique uma cópia com a pilha de imagens instalada e, em seguida, coloque um trabalho de miniatura na fila
Interprete qual o ramo suportado pelas evidências
APROVADO: o descodificador falha antes do trabalho da fila, ou a descodificação é bem-sucedida enquanto o trabalhador nunca grava o derivado. Registe a versão, a identidade e a carga de trabalho exatas que foram aprovadas, para que a conclusão permaneça condicional em vez de se tornar uma afirmação universal.
REPROVADO: apenas uma câmara ou um modo de compressão falha, pelo que o suporte deve ser limitado a essa amostra. Um resultado reprovado não prova automaticamente o ramo oposto quando a rede, a memória, as permissões ou a consistência da origem podem influenciar ambos; isole essas dependências partilhadas antes de avançar.
EXCEÇÃO OU RESULTADO AMBÍGUO: preserve os originais, pare as tentativas repetidas e mantenha um caminho de pré-visualização JPEG conhecido como funcional enquanto investiga. Preserve os registos e não execute comandos de reparação, limpeza, destruição, reparticionamento ou alteração recursiva de proprietários até existir uma cópia recuperável.
Aplique a ação correspondente e reproduza a falha original
Aplique a ação correspondente ao ramo observado e, em seguida, repita a condição original em vez de um substituto reduzido. A decisão só é válida quando o descodificador falha antes do trabalho da fila, ou quando a descodificação é bem-sucedida enquanto o trabalhador nunca grava o derivado, ao longo de dois ciclos ou do reinício, suspensão, interrupção ou transição de carga relevante.
Utilize as bibliotecas Immich só de leitura para verificar o fluxo de trabalho dependente mais próximo, mas mantenha o acionador original inalterado. Os conjuntos de dados, partilhas, contentores, utilizadores e pontos de recuperação não relacionados devem manter o acesso e o momento anteriores.
O limite de paragem é explícito: se apenas uma câmara ou um modo de compressão falhar, pelo que o suporte deve ser limitado a essa amostra, volte à última configuração verificada, conserve as evidências e avance para um teste mais aprofundado da plataforma ou do hardware apenas quando o ramo for reproduzível.
Depois de o resultado pretendido se manter, compare-o com o agendamento de trabalhos de miniaturas, para garantir que a correção não transfere o risco para um serviço vizinho. Um teste-alvo bem-sucedido que crie uma nova falha de cópia de segurança, identidade, tempo limite ou disponibilidade continua a ser uma alteração falhada.
Perguntas frequentes
Para diagnosticar pré-visualizações RAW em falta, as pesquisas restantes geralmente dizem respeito a por que razão alguns ficheiros RAW de uma câmara funcionam, se as permissões dos ficheiros podem parecer corretas mas os trabalhadores continuarem a falhar e se as pré-visualizações devem ser regeneradas em toda a biblioteca. As respostas abaixo mantêm esses casos-limite separados da decisão principal.
O limite de aceitação não muda: o descodificador falha antes do trabalho da fila, ou a descodificação é bem-sucedida enquanto o trabalhador nunca grava o derivado. Se uma condição posterior alterar o sistema de ficheiros, a identidade, o caminho de rede ou a versão da aplicação, repita apenas o teste discriminador afetado por essa alteração.
Pare de alargar a experiência quando apenas uma câmara ou um modo de compressão falhar, pelo que o suporte deve ser limitado a essa amostra. Nesse momento, preserve os originais, pare as tentativas repetidas e mantenha um caminho de pré-visualização JPEG conhecido como funcional enquanto investiga; preserve as evidências antes de encaminhar o problema para o responsável pela plataforma, pelo armazenamento ou pelo hardware.
Por que razão alguns ficheiros RAW de uma câmara funcionam?
O firmware da câmara, o modo de compressão, a pré-visualização incorporada e a versão do descodificador podem diferir dentro da mesma extensão.
As permissões dos ficheiros podem parecer corretas, mas os trabalhadores continuarem a falhar?
Sim. O trabalhador pode utilizar um caminho de contentor, um UID ou uma montagem de saída diferentes.
As pré-visualizações devem ser regeneradas em toda a biblioteca?
Não até uma amostra funcionar e a capacidade disponível da fila e do armazenamento conseguir absorver o trabalho.
O diagnóstico termina quando a mesma carga de trabalho faz com que as evidências sigam a descodificação RAW não suportada ou com falhas, ou a falha na fila de miniaturas, no trabalhador, nas permissões ou no armazenamento de saída, e a ação correspondente elimina o sintoma original sem criar um segundo. Se nenhum dos ramos continuar reproduzível, mantenha os registos e o estado guardado intactos; a incerteza é motivo para encaminhar o problema, não para acumular mais correções.
Suporte e Dicas
Mais para Ler

Guia de armazenamento para gravação de TV em direto: capacidade, retenção e limpeza
Meça gravações reais, reserve margem de segurança, combine limites de idade e capacidade e confirme que o programa elegível mais antigo é removido antes...

Fluxo de recuperação de metadados de multimédia doméstica após o restauro de uma base de dados
Proteja o estado restaurado, verifique a identidade e os caminhos dos ficheiros multimédia e, em seguida, corrija as capas ou correspondências em falta numa...

Lista de verificação de compatibilidade do cliente Jellyfin para áudio, vídeo e legendas
Teste ficheiros representativos, uma variável de cada vez, e registe Direct Play, remux, conversão de áudio, transcodificação de vídeo ou falha para cada cliente.

