Determine se um erro do Immich é do lado do cliente ou do servidor repetindo a mesma ação com uma única variável alterada e acompanhando o pedido com falha ao longo do percurso.
Uma faixa de aviso na aplicação móvel que diz «erro do servidor» pode, ainda assim, ter origem no estado do cliente, no TLS, num proxy inverso ou num pedido que o servidor rejeitou corretamente. Da mesma forma, uma falha apenas no browser não prova que o problema esteja no browser. Mantenha a conta, o ficheiro e a ação iguais; compare clientes e rotas; depois, use os códigos de estado e os registos com horas sincronizadas para localizar a primeira camada em que ocorre a falha.
Repita a mesma ação num segundo cliente
Escolha uma ação determinística, como iniciar sessão, abrir um ficheiro conhecido, carregar a mesma fotografia pequena ou executar a mesma pesquisa. Repita-a com a mesma conta num browser e num cliente móvel, sem alterar a rota de rede. Registe a hora exata e o resultado de ambas as tentativas.
Um relato recente sobre o Immich, em que um cliente Android falhou enquanto eram testadas outras formas de acesso, ilustra o valor da comparação entre clientes. A causa num tópico não é generalizável, mas um resultado específico de um cliente reduz significativamente o número de locais a investigar.
Se todos os clientes falharem ao realizar a mesma ação ao mesmo tempo, o servidor, a base de dados, o armazenamento ou o percurso de rede partilhado tornam-se hipóteses mais prováveis. Se apenas um cliente falhar enquanto outro funcionar através do mesmo ponto final, verifique a versão do cliente, o estado em cache, as permissões, a confiança local nos certificados e o pedido exato que é diferente.
Altere a rota sem alterar a conta ou o ficheiro
Em seguida, compare uma rota local de confiança com a rota habitual através de proxy inverso, VPN, túnel ou acesso remoto. Use a mesma conta e a mesma ação. Se a rota local funcionar e a remota falhar, é menos provável que o problema esteja no próprio registo multimédia e mais provável que esteja nas camadas de DNS, TLS, proxy, firewall ou encaminhamento para o servidor de origem.
O guia da ZimaSpace sobre o diagnóstico de rotas locais e remotas explica porque é que o sucesso na LAN e o sucesso através da Internet são provas diferentes. Aplique esta distinção ao Immich antes de reinstalar uma aplicação móvel ou reconstruir o servidor.
Se ambas as rotas falharem da mesma forma, pare de alterar as definições do proxy e analise o pedido do lado da aplicação. Se apenas a rota pelo proxy falhar, registe o estado do proxy, o resultado do TLS, a resposta do servidor de origem e o tempo limite. Esta comparação com uma única variável evita que uma mensagem do cliente faça a investigação seguir pela camada errada.
Use os códigos de estado como pistas, não como vereditos finais
As classes de estado HTTP ajudam a identificar onde procurar, mas não identificam automaticamente o componente que causou o problema. Um 4xx significa, muitas vezes, que o pedido, a autenticação ou a autorização não foram aceites; um 5xx indica que um componente do lado do servidor não conseguiu satisfazer o pedido. Os proxies podem gerar qualquer uma destas classes antes de o Immich receber o pedido.
O guia de referência dos registos de acesso destaca o código de estado, o caminho do URL, o tempo do pedido, o anfitrião remoto e os identificadores do pedido como campos úteis para a resolução de problemas. Registe estes valores para a ação que falha, em vez de percorrer milhares de linhas sem relação com o problema.
Se o proxy registar um erro 502 ou um tempo limite sem um pedido Immich correspondente, siga o percurso a montante. Se o Immich registar um pedido e devolver um erro 4xx determinístico, verifique a autenticação, as permissões ou o conteúdo do pedido. Se o cliente comunicar uma falha, mas todas as camadas do lado do servidor mostrarem o estado 2xx, verifique a análise sintática do cliente, a cache local ou os pedidos subsequentes.
Correlacione a taxa de erros, a latência e os registos do servidor num mesmo carimbo de data/hora
Um único pedido falhado pode ser um caso isolado. Reproduza a ação cinco a dez vezes e registe a taxa de sucesso e a latência, enquanto acompanha os registos relevantes do servidor e do proxy. Se os erros aumentarem durante períodos de pressão sobre os recursos ou picos na fila, o servidor poderá estar temporariamente indisponível, mesmo que uma segunda tentativa tenha êxito.
A visão geral da Better Stack sobre erros e latência como indicadores do serviço distingue a taxa de erros da latência e do tráfego. Esta perspetiva ajuda a distinguir um pedido malformado de um único cliente de um percurso do servidor que só degrada sob carga.
Se os registos do servidor contiverem a mesma exceção para vários clientes, considere que a causa está no servidor até prova em contrário. Se o servidor nunca receber o pedido que falha, verifique o DNS, o TLS, o proxy e a rede do cliente. Se apenas um cliente gerar um pedido com um formato diferente, atualize ou reponha esse cliente depois de guardar provas suficientes para confirmar a diferença.
Faça o diagnóstico final com um teste de duas por duas
Utilize dois clientes e duas rotas: navegador local, navegador remoto, dispositivo móvel local e dispositivo móvel remoto. Mantenha a mesma conta e o mesmo recurso de teste. Esta matriz permite distinguir falhas específicas do cliente de falhas específicas da rota e de falhas do servidor que afetam todas as combinações.
A causa está no cliente quando um cliente falha em ambas as rotas, enquanto outro passa. A causa está na rota quando ambos os clientes falham apenas numa das rotas. A causa está no servidor quando as quatro combinações reproduzem o mesmo erro da aplicação e os registos do servidor mostram a mesma operação com falhas.
Depois de corrigir a camada identificada, volte a executar as quatro células e reinicie uma vez o componente afetado. Pare quando a célula que falhava originalmente passar sem comprometer os controlos. Escale o problema com a matriz, os carimbos de data/hora, os estados HTTP, excertos dos registos do proxy e do servidor, as versões dos clientes e um pedido reproduzível, em vez de uma captura de ecrã genérica.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



