O que faz com que as fotografias HEIC percam as pré-visualizações numa galeria autoalojada?

As pré-visualizações HEIC desaparecem quando a galeria não consegue descodificar o original, gerar a respetiva imagem derivada ou entregar essa imagem ao cliente atual.

Uma galeria auto-hospedada normalmente preserva o original HEIC, criando miniaturas e pré-visualizações JPEG ou WebP para navegadores e telemóveis que podem não apresentar diretamente todos os perfis HEIF. O original pode continuar disponível para transferência mesmo quando a linha temporal está vazia, porque a corrupção, um novo perfil de codificação do telemóvel, dimensões muito grandes, suporte de descodificação em falta, tarefas de processamento falhadas, registos de miniaturas desatualizados ou o carregamento do original no cliente afetam apenas o percurso das imagens derivadas. Diagnostique um único ficheiro, desde os bytes originais até à pré-visualização gerada.

Confirme se o ficheiro HEIC original está intacto

Transfira o original a partir da galeria e compare o tamanho e o hash com o ficheiro do telemóvel de origem, da exportação ou da cópia de segurança. Abra-o numa aplicação de ambiente de trabalho fiável que suporte HEIC.

Utilizadores do Immich relataram carregamentos de ficheiros HEIC e DNG após os quais as miniaturas e pré-visualizações deixaram de ser geradas, tornando importante distinguir um original danificado de um processo de geração de derivados com falhas. O sintoma visível foi a ausência de miniaturas após o carregamento.

Se o original transferido estiver truncado ou corrompido, corrija o processo de transferência e carregue-o novamente a partir de uma fonte verificada. Se o original abrir corretamente, preserve-o e continue com as verificações de metadados, descodificação e tarefas.

Compare os metadados HEIC funcionais e com falhas

Escolha um ficheiro HEIC que gere pré-visualizações e outro que não gere. Compare o modelo do dispositivo, a versão do sistema operativo, as dimensões, a profundidade de bits, o perfil de cor, as imagens auxiliares, a orientação, os metadados HDR, o tamanho do ficheiro e as marcas do contentor.

O software novo do telemóvel pode introduzir um perfil que o descodificador do servidor atual não compreende. Um problema do Immich identificou ficheiros HEIC do iOS 18 que falhavam ao gerar miniaturas, com mensagens de cabeçalho incorreto, enquanto as imagens de versões anteriores do iOS continuavam a funcionar, isolando uma diferença no novo perfil de origem.

Teste outra fotografia do mesmo telemóvel depois de alterar apenas uma definição da câmara, para classificar a falha. Não converta nem substitua a biblioteca original até conhecer o perfil incompatível e a versão do servidor.

Verifique as dimensões da imagem e os limites de recursos

Registe a largura, a altura, os megapíxeis, o tamanho do ficheiro e as imagens auxiliares incorporadas da imagem com falhas. Os ficheiros HEIC muito grandes podem exigir substancialmente mais memória durante a descodificação do que o seu tamanho comprimido sugere.

O Immich documentou ficheiros HEIC grandes, com 200 megapíxeis, que não conseguiam produzir miniaturas nem apresentar pré-visualizações. O limite prático era dimensões HEIC extremamente grandes, e não a utilização normal da galeria.

Monitorize a memória, o CPU, os limites do contentor e os eventos de falta de memória do trabalhador de miniaturas enquanto processa um único ficheiro. Se as imagens HEIC mais pequenas funcionarem, aumente os recursos disponíveis para o trabalhador ou mantenha uma cópia de pré-visualização compatível sem eliminar o original em resolução total.

Featured

ZimaCube 2 NAS Pessoal Cloud para Casa

ZimaCube2

$799.00 - $2,499.00

Buy Now

Leia o primeiro erro de descodificação do trabalhador de miniaturas

Execute a tarefa de miniaturas em falta ou de regeneração para um único recurso afetado e acompanhe o registo do microsserviço ou do trabalhador. Registe o primeiro erro de descodificação, cabeçalho, espaço de cor, permissões ou escrita, em vez da falha genérica final.

Relatórios recentes do Immich continuam a mostrar falhas na geração de miniaturas para ficheiros HEIC específicos após atualizações. Um problema de 2026 identifica uma falha no processamento de HEIC associada a uma atualização.

Se todos os ficheiros novos falharem depois do primeiro erro HEIC, reinicie apenas o trabalhador com falhas depois de preservar os registos e verifique o estado da fila. Um único recurso malformado não deve ocultar o facto de o próprio processo do trabalhador ter deixado de gerar todas as pré-visualizações seguintes.

Verifique as bibliotecas de descodificação e a compatibilidade das versões

Registe a versão da galeria, a imagem do contentor, a biblioteca de processamento de imagens, o descodificador HEIF, a arquitetura da CPU e se as compilações específicas do hardware foram alteradas durante a atualização. Compare-os com a última implementação conhecida como funcional.

Algumas falhas de HEIC afetam apenas um subconjunto de imagens, mesmo dentro da mesma versão do servidor. Um problema do Immich relata que apenas determinados ficheiros HEIC falharam, indicando um limite relacionado com funcionalidades do formato, e não uma ausência total de suporte para HEIC.

Teste o mesmo original com a versão anterior da aplicação ou com uma imagem isolada do trabalhador atual. Reverta apenas a partir de uma cópia de segurança consistente da base de dados e da configuração; não faça um downgrade cego da base de dados de produção para testar um descodificador de imagens.

Separe a falha da pré-visualização no servidor do carregamento do original no cliente

Abra o recurso afetado no cliente Web, na aplicação móvel e numa sessão de navegador privado. Registe se a miniatura da linha temporal, a pré-visualização média, o derivado em tamanho completo e a transferência do original falham de forma independente.

Um navegador pode não conseguir apresentar o original HEIC, enquanto uma pré-visualização gerada deveria funcionar. Um problema do Immich no Safari descreve uma falha no carregamento do original HEIC, embora o cliente pudesse recorrer a uma pré-visualização ou a um derivado em tamanho completo.

Se apenas um cliente falhar, limpe a resposta do recurso em cache desse cliente e compare as definições de carregamento do original. Se nenhum cliente tiver a miniatura e o registo do trabalhador não mostrar qualquer ficheiro gerado, mantenha o diagnóstico do lado do servidor.

Regenerar apenas os derivados em falta depois de corrigir a causa

Faça uma cópia de segurança da base de dados e do volume de metadados e, em seguida, execute a tarefa de miniaturas em falta num pequeno conjunto afetado. Confirme que são criados novos derivados sem substituir os originais.

As versões do Immich orientaram os utilizadores com miniaturas danificadas a executar a tarefa de miniaturas em falta após as correções relevantes, o que apoia a regeneração direcionada após a reparação, em vez de eliminar primeiro todo o armazenamento de miniaturas.

O guia da ZimaSpace sobre cópias de segurança privadas de fotografias do iPhone explica o requisito complementar: preservar e verificar as fotografias originais de forma independente das pré-visualizações da galeria.

O problema está resolvido quando o hash do original permanece inalterado, o trabalhador gera miniaturas para o perfil HEIC com falhas, todos os clientes suportados carregam o derivado e uma nova fotografia do mesmo telemóvel é processada corretamente sem ser necessário reconstruir toda a biblioteca.