O Immich normalmente deixa de devolver fotografias privadas pesquisáveis após um reinício porque a Pesquisa Inteligente perdeu o caminho para a aprendizagem automática, ainda não terminou de preparar o modelo ou não consegue concluir as tarefas e leituras de armazenamento que criam os embeddings de pesquisa.
Se a linha temporal ainda mostrar os originais, é provável que as fotografias não estejam em falta; a camada de pesquisa é que está incompleta. Trate um resultado vazio primeiro como um problema do percurso do serviço, preserve a base de dados e a biblioteca de carregamentos e, antes de reconstruir seja o que for, distinga entre um contentor de aprendizagem automática indisponível, tarefas atrasadas, um endpoint incompatível ou uma falha de permissões no caminho persistente.
Separe resultados de pesquisa em falta de fotografias em falta
Abra diretamente vários recursos conhecidos a partir da linha temporal, dos álbuns e de uma biblioteca privada antes de testar a pesquisa. Se funcionar, significa que a base de dados consegue localizar os registos e que o Immich consegue ler os ficheiros; se falhar, trata-se de um incidente mais abrangente da biblioteca ou do armazenamento. Nesse caso, pare de fazer alterações específicas à pesquisa e proteja os caminhos afetados.
Faça três pesquisas repetíveis: um termo que funcionava anteriormente, um termo visualmente óbvio e um recurso carregado recentemente, depois de o respetivo trabalho em segundo plano dever estar concluído. Registe se os resultados estão vazios, desatualizados ou limitados a fotografias mais antigas. Estes resultados permitem distinguir uma falha total do endpoint de um atraso na indexação.
Um tópico comunitário de resolução de problemas reúne verificações da Pesquisa Inteligente relacionadas com reinícios, incluindo a acessibilidade do endpoint e a repetição de tarefas. Use a sua sequência de diagnóstico da camada de pesquisa como evidência do caso, não como motivo para eliminar a base de dados ou regenerar todos os recursos.
Verifique o percurso da aprendizagem automática após o reinício
Inspecione o estado do servidor e do contentor de aprendizagem automática e, em seguida, teste o URL de aprendizagem automática configurado a partir do espaço de nomes de rede que o chama. Um endpoint acessível com pedidos de modelo bem-sucedidos passa este ramo; uma recusa de ligação, uma falha de resolução de nomes ou um contentor não saudável identifica o percurso do serviço a reparar.
Compare o nome do serviço implementado, a porta, o valor da variável de ambiente, a versão da imagem e a pertença à rede com a última definição Compose conhecida por funcionar. Recrie apenas o contentor afetado depois de corrigir a incompatibilidade. Um simples reinício não substitui o ambiente obsoleto do contentor, por isso confirme o valor efetivo na carga de trabalho recriada.
Um caso comunicado do Immich v2.6.1 associou a Pesquisa Inteligente falhada a um contentor de aprendizagem automática não saudável. O relatório de falha específico da versão apoia a verificação do estado e dos registos; não prova que todas as falhas após um reinício sejam causadas por essa regressão.
Verifique a preparação do modelo, as tarefas e os caminhos persistentes
Observe os registos da aprendizagem automática enquanto envia uma pesquisa conhecida. O primeiro pedido pode carregar ou transferir um modelo e utilizar temporariamente mais memória; se houver progresso seguido de uma resposta bem-sucedida, este ramo passa. Evicções repetidas, terminações por falta de memória ou falhas de transferência apontam para reparações de memória, persistência da cache ou rede.
Inspecione as contagens de tarefas da Pesquisa Inteligente e as falhas recentes sem as limpar. Se o endpoint estiver saudável, mas as tarefas continuarem falhadas ou em fila, repita um pequeno lote controlado e observe se as contagens diminuem. Se um recurso for processado com êxito, repare a simultaneidade dos trabalhadores ou a dependência falhada antes de agendar uma reindexação completa.
Confirme que a base de dados, a biblioteca de carregamentos e a cache do modelo estão montadas nos caminhos persistentes pretendidos e com a identidade esperada. O guia relacionado da ZimaSpace sobre o comportamento do reconhecimento do Immich ajuda a distinguir o acesso e o âmbito da indexação de um original em falta.
Aplique a correção correspondente e volte a testar após dois reinícios
Corrija apenas a causa confirmada: restaure o nome do endpoint, recrie o contentor com o ambiente correto, torne a cache do modelo persistente, reduza a simultaneidade medida, repare a propriedade ou repita as tarefas falhadas da Pesquisa Inteligente. Mantenha disponível o ficheiro Compose anterior e uma cópia de segurança da base de dados; não elimine os embeddings como primeira resposta.
Volte a testar as mesmas três consultas, um recurso antigo e um carregamento novo. Para passar, deve obter resultados úteis, filas de tarefas a diminuir, originais legíveis e um estado estável da aprendizagem automática. Reinicie a pilha pela ordem normal das dependências e repita o teste; depois reinicie o anfitrião uma vez para confirmar que as montagens e a resolução de nomes sobrevivem ao arranque.
Reverta as alterações se os resultados diminuírem, os originais deixarem de ser legíveis ou a base de dados comunicar erros de consistência. Escale o problema com a versão do Immich, o endpoint efetivo, o estado do contentor, os registos relevantes, as contagens de tarefas, o nome do modelo e os mapeamentos de montagem se a mesma falha regressar após dois reinícios; mantenha a instância pesquisável anterior isolada, mas recuperável.
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...

