Erros intermitentes do Immich durante uma importação móvel de grandes dimensões normalmente significam que uma camada está a falhar sob sobreposição, não que toda a biblioteca ou todos os recursos carregados estejam corrompidos.
As importações de grandes dimensões combinam o comportamento das aplicações móveis em segundo plano, pedidos longos, limites de proxy inverso ou túnel, gravações na base de dados, E/S de armazenamento, processamento de miniaturas e vídeos e filas de aprendizagem automática. Comece por recolher um pequeno grupo de recursos que falharam e os respetivos carimbos de data e hora. Depois, determine se a falha começa no telemóvel, no percurso de rede, no servidor da aplicação ou numa dependência saturada.
Classifique o grupo de erros antes de tentar novamente tudo
Agrupe as falhas por tipo de conteúdo multimédia, tamanho do ficheiro, dispositivo de origem, percurso de rede e hora. Se apenas os vídeos grandes falharem, investigue a duração dos pedidos e os limites de carregamento antes da CPU. Se fotografias e vídeos aleatórios falharem nos mesmos intervalos de maior atividade, os recursos partilhados do servidor ou a instabilidade da rede tornam-se hipóteses mais fortes.
Um relato de 2026 de um utilizador do Immich que descreve muitos erros de carregamento móvel é útil porque mostra como uma grande fila de conteúdos no telemóvel pode revelar falhas repetidas que exigem um diagnóstico por item e por percurso. Não comprova a existência de um único erro universal no cliente móvel.
Não selecione “tentar novamente tudo” como primeira ação de diagnóstico. Guarde os nomes ou IDs de dez recursos que falharam, um item de controlo que tenha sido carregado com êxito e a janela correspondente dos registos do cliente e do servidor. Um pequeno grupo conhecido permite testar alterações sem gerar uma nova vaga que oculte as provas originais.
Compare os carregamentos locais com o percurso remoto normal
Carregue os mesmos ficheiros de teste pequenos e grandes através de uma rede Wi-Fi local estável, diretamente para o ponto final local de confiança, e repita através do nome de anfitrião remoto habitual, VPN, túnel ou proxy inverso. Mantenha a conta e o recurso inalterados para que a rota seja a principal variável.
Um relato de falhas na cópia de segurança de ficheiros grandes destaca por que motivo os limites de pedidos do proxy ou túnel pertencem a este ramo de diagnóstico. O serviço e os limiares indicados são específicos da implementação; o teste geral consiste em verificar se a transferência local direta é bem-sucedida enquanto o percurso remoto falha consistentemente.
Se ambos os percursos falharem nos mesmos recursos, siga as provas do servidor e do armazenamento. Se apenas o percurso remoto falhar, inspecione o tamanho máximo do corpo, a colocação em buffer dos pedidos, os tempos limite de inatividade e de leitura, a terminação TLS, as transições da rede móvel e as retransmissões. Alterar a simultaneidade das miniaturas não irá corrigir um pedido que nunca chega completamente ao Immich.
Correlacione os erros com o crescimento das filas e a pressão sobre os recursos
As importações de grandes dimensões podem continuar a aceitar carregamentos enquanto as tarefas em segundo plano se acumulam. Observe a CPU, a pressão da memória, a latência da E/S de blocos, a capacidade de resposta da base de dados, os reinícios dos contentores e a conclusão das tarefas durante a janela de falha. Uma utilização elevada, por si só, não é prova; a métrica tem de mudar ao mesmo tempo que os erros.
O artigo de monitorização de recursos do Docker sobre métricas de CPU, memória, rede e disco dos contentores demonstra o valor de comparar contentores em vez de consultar uma única média global do anfitrião. No Linux, combine as métricas dos contentores com provas da utilização do armazenamento e da pressão da memória do anfitrião relativas aos mesmos carimbos de data e hora.
Se a pressão da memória provocar o encerramento de contentores, a latência do armazenamento aumentar juntamente com os erros de carregamento ou o tempo de resposta da base de dados disparar enquanto a fila deixa de avançar, reduza apenas a carga de trabalho ou a simultaneidade responsáveis e repita o grupo fixo. Se os gráficos de recursos permanecerem estáveis, prossiga para os registos da aplicação e o diagnóstico do percurso de rede.
Trate a taxa de erros e a latência da cauda como sinais de carga
Um sistema pode parecer saudável com base no tempo médio de resposta, enquanto uma pequena percentagem dos pedidos excede o tempo limite durante os picos. Registe o número de carregamentos tentados, as falhas, o tempo de resposta mediano e os pedidos mais lentos da cauda ao longo de uma janela controlada. Isto torna o termo “intermitente” mensurável em vez de anedótico.
A estrutura de testes de carga na análise de erros e latência recomenda analisar classes de estado, problemas de ligação, distribuições e correlações em séries temporais. Não precisa de sujeitar a biblioteca familiar a uma carga agressiva; utilize a mesma estrutura analítica com a taxa real de importação.
Se reduzir significativamente a taxa de chegada diminuir as falhas enquanto cada recurso individual for carregado com êxito, a pilha atual não tem margem suficiente para essa intensidade de importação. Se os mesmos ficheiros falharem mesmo um de cada vez, o problema é específico do recurso, do percurso ou um erro determinístico do software, e não uma saturação genérica.
Reduza uma fonte de pressão e teste novamente o mesmo padrão de importação
Escolha a alteração mais segura prevista pelas provas: reduza uma única simultaneidade em segundo plano, pause outro contentor pesado, utilize o percurso local, faça a importação fora de uma janela de cópia de segurança ou corrija um tempo limite do proxy. Não altere simultaneamente os limites da CPU, o armazenamento, as regras do proxy e as versões da aplicação.
O fluxo de trabalho do ZimaSpace para interrupções da cópia de segurança de fotografias do telemóvel fornece o ramo relativo ao telemóvel: o agendamento em segundo plano, os originais disponíveis apenas na nuvem e as alterações nas condições da rede podem interromper os carregamentos mesmo quando o servidor está saudável.
Considere o teste bem-sucedido quando o grupo fixo for carregado com êxito e a mesma importação de maiores dimensões decorrer com uma taxa de erros estável, filas a avançar e um desempenho interativo aceitável. Escale o problema quando as falhas persistirem com baixa carga ou se repetirem nos mesmos recursos; inclua os registos do cliente, os registos do servidor, o estado do proxy, os gráficos de recursos, o tipo e o tamanho do ficheiro e o primeiro pedido que falhou.
Suporte e Dicas
Mais para Ler

Como otimizar as ligações à base de dados do Immich para contentores simultâneos
Não aumente primeiro o valor de max_connections. Meça as sessões do Immich, some a procura total de cada contentor, preserve margem para o administrador...

Como evitar trabalhos ou importações duplicados no Immich
Separe os trabalhos repetidos dos recursos duplicados. Utilize um único caminho de ingestão canónico, controle as novas tentativas e as alterações de caminho e,...

Como reparar o Immich depois de o volume da base de dados ficar cheio
Nunca elimine o WAL do PostgreSQL para libertar espaço. Pare as escritas do Immich, preserve o estado da base de dados, adicione capacidade de...

