O Jellyfin costuma apresentar dados desatualizados após uma mudança de armazenamento porque o serviço vê o caminho antigo, não consegue ler o novo ponto de montagem ou ainda não concluiu uma análise válida da nova localização.
O painel apresenta itens antigos, itens em falta ou uma mistura de ambos? Não elimine a biblioteca nem esvazie o lixo primeiro. Registe os caminhos antigo e novo exatos, o estado da montagem, o proprietário do serviço e o resultado da análise, para que cada cenário possa ser testado sem destruir metadados.
Verifique que caminho o Jellyfin consegue realmente ver
Inspecione o caminho a partir do processo ou contentor do Jellyfin, não apenas da shell do anfitrião. Confirme que a montagem existe após o arranque, que a conta de serviço consegue listar e ler um ficheiro de exemplo e que o mapeamento do contentor corresponde ao caminho armazenado na configuração da biblioteca.
Se o caminho estiver vazio ou inacessível, corrija primeiro a montagem, o UID/GID ou o volume do contentor. Uma montagem de armazenamento que só aparece após o início de sessão manual pode deixar o Jellyfin a analisar um diretório vazio durante o arranque.
Compare o caminho antigo e o novo na configuração da biblioteca e num registo da base de dados. Se ambos permanecerem, o Jellyfin pode legitimamente apresentar um item válido e uma referência obsoleta.
Distinguir metadados obsoletos de uma análise falhada
Depois de o caminho estar acessível, execute uma análise controlada e acompanhe os registos em busca do nome da biblioteca, da contagem de itens, de erros de permissões e de ficheiros ignorados. Compare um item antigo conhecido com um ficheiro adicionado recentemente. Se a análise terminar, mas os caminhos antigos permanecerem, a base de dados ainda contém a localização anterior ou o novo caminho foi adicionado sem remover a referência antiga.
Não interprete um cartaz em cache como prova de que o ficheiro multimédia está disponível. As regras de caminhos de armazenamento tornam o sistema de ficheiros montado e o caminho da aplicação verificações distintas.
Execute uma única análise controlada depois de corrigir o mapeamento e, em seguida, compare a contagem de itens e um ficheiro conhecido. Análises repetidas antes de corrigir o caminho podem criar um estado ainda mais confuso.
Repare apenas depois de confirmar o cenário
Corrija o mapeamento do caminho ou as permissões, reinicie uma vez e execute uma nova análise. Se o caminho na base de dados estiver errado, atualize a localização da biblioteca com a alteração mínima possível e confirme a contagem de itens esperada antes de limpar entradas antigas. Preserve os dados da aplicação e uma cópia de segurança antes de qualquer operação de metadados em massa.
A recuperação está confirmada quando o serviço continua a ver o novo caminho após o reinício, um cliente representativo reproduz um item e uma segunda análise não recria o estado obsoleto. Proceda à escalada quando o sistema de ficheiros indicar corrupção, a base de dados contiver caminhos em conflito ou o problema regressar após uma montagem e um reinício limpos.
Após a reparação, reinicie com a montagem disponível durante o arranque e repita a análise. Os dados obsoletos só ficam resolvidos quando o mesmo caminho continua visível após o reinício.
Proceda à escalada quando o caminho continua a reaparecer
Mantenha o mapeamento reparado quando um reinício limpo, uma análise e uma reprodução representativa utilizarem o novo caminho sem recriar a entrada antiga.
Pare a limpeza quando o caminho antigo regressar, a base de dados contiver identidades em conflito ou a montagem de armazenamento mudar entre análises. Preserve primeiro a base de dados e o mapa de caminhos atual.
Proceda à escalada para uma reposição a partir de uma cópia de segurança ou para uma reparação específica da base de dados quando o sistema de ficheiros estiver saudável, mas as referências obsoletas persistirem após um mapeamento e um reinício limpos.
Suporte e Dicas
Mais para Ler

Como otimizar as ligações à base de dados do Jellyfin para contentores simultâneos
Comece com um único proprietário da base de dados e um comportamento de bloqueio do SQLite devidamente avaliado; adicione outro backend apenas quando a...

Como evitar tarefas ou importações duplicadas no Jellyfin
O trabalho duplicado geralmente resulta de agendadores sobrepostos ou de mais do que um processo de escrita; atribua um responsável, um caminho e uma...

Como reparar o Jellyfin depois de o volume da base de dados ficar cheio
Pare as gravações, preserve a base de dados e os ficheiros WAL, liberte espaço sem eliminar o estado de forma indiscriminada e, em seguida,...

