Los datos obsoletos de Immich tras un cambio en la ruta de almacenamiento pueden deberse a tres causas distintas que no deben confundirse: un traslado de la raíz de medios administrados, un cambio de la ruta de importación de una biblioteca externa o un cliente que todavía muestra datos en caché. Las versiones modernas de Immich pueden conciliar una ubicación de medios administrados trasladada cuando la ubicación configurada y el montaje del volumen se mantienen coherentes, mientras que los traslados de bibliotecas externas aún pueden tratarse como identidades de recursos nuevas.
Conserva la ruta antigua y la base de datos antes de volver a analizar. Primero comprueba qué ruta ve el contenedor en ejecución y luego determina si el registro del servidor de Immich es incorrecto o si solo está desactualizado un cliente. Esa distinción determina si debes reparar un montaje, restaurar una ruta estable visible para el contenedor, volver a analizar un subconjunto de prueba o borrar solo la caché del cliente.
Distingue entre el traslado de la raíz de medios administrados y el de una biblioteca externa
Si cambiaste la ubicación en el host de las cargas administradas por Immich, verifica que la configuración efectiva de la ubicación de los medios y el montaje entre el host y el contenedor hayan cambiado conjuntamente. Un traslado moderno de medios administrados no debe diagnosticarse igual que un cambio de nombre de una ruta de importación de una biblioteca externa.
El mapa del estado persistente de Immich de ZimaSpace resulta útil aquí porque la base de datos y las rutas del sistema de archivos forman un mismo límite de recuperación. No basta con tener los archivos correctos en el host si el contenedor está montado en otra ubicación.
Si la raíz de medios administrados no coincide, corrige primero el entorno y la asignación de volúmenes, y reinicia el servicio antes de ejecutar tareas de la biblioteca. Si la ruta cambiada pertenece a una biblioteca externa, conserva intacta la base de datos y prueba esa situación por separado.
Mantén estable la ruta de la biblioteca externa en el contenedor siempre que sea posible
En una biblioteca externa, lo más seguro es mover el almacenamiento en el host manteniendo sin cambios la ruta de importación visible para el contenedor. Si cambia la ruta que se presenta a Immich, registra un pequeño conjunto de ID de recursos, álbumes, personas y rutas antiguas antes de iniciar un análisis, para poder comprobar si los recursos existentes se volvieron a vincular o se crearon de nuevo.
Un informe de cambio de rutas de una biblioteca externa de Immich describió cómo los archivos reubicados se trataron como recursos nuevos, se volvieron a procesar y perdieron las relaciones existentes solo en Immich. Es un caso específico de una versión, pero respalda la regla prudente de que un cambio en la ruta de una biblioteca externa no equivale automáticamente a un cambio de nombre transparente.
Si un subconjunto de prueba aparece como recursos nuevos mientras los registros antiguos figuran como ausentes o en la papelera, detén el análisis completo. Si es viable, restaura la ruta anterior visible para el contenedor o usa un método de migración adecuado para la versión; no reescribas manualmente las rutas en la base de datos de producción sin una copia de seguridad probada.
No confundas este caso con una migración de Storage Template para archivos administrados por Immich. El síntoma puede parecerse en la cronología, pero la propiedad de los archivos y la ruta de migración compatible son diferentes.
Distingue las rutas almacenadas en el servidor de la caché del cliente
Inspecciona el mismo recurso conocido desde el cliente web y otro cliente autenticado y compáralos con los registros del servidor o la ruta visible para el servidor. Si los trabajos del servidor siguen indicando la ruta antigua, borrar la caché del navegador no puede reparar el registro subyacente.
Más adelante, un problema de metadatos de una ruta antigua de Immich mostró que el procesamiento seguía haciendo referencia a una ruta anterior de la biblioteca externa después de cambiarla de nombre. Esto es un indicio sólido de que conviene comprobar las rutas usadas por los trabajos antes de culpar a la interfaz web o móvil.
Si la ruta del servidor es correcta, pero solo una vista web está desactualizada, actualiza o borra la caché de ese cliente y vuelve a probar el archivo original. Las miniaturas en caché y el estado obsoleto del cliente pueden hacer que un servidor ya reparado parezca averiado, mientras que una vista previa en caché también puede hacer que una ruta del servidor averiada parezca correcta.
Repara el límite mínimo de la ruta y valida un análisis controlado
Realiza una única corrección reversible: sincroniza la configuración de medios administrados con el montaje, restaura la ruta anterior de la biblioteca externa dentro del contenedor, corrige una ruta de importación o borra la caché de un cliente. Haz una copia de seguridad de la base de datos antes de cualquier acción que pueda provocar que se vuelva a detectar una biblioteca grande.
Ejecuta el análisis de nuevo más pequeño que resulte práctico y comprueba si los registros existentes siguen asociados, si dejan de aparecer errores de rutas antiguas y si no aparecen recursos duplicados con rutas antiguas y nuevas. Después, abre algunos originales, verifica las relaciones con álbumes y personas, realiza una búsqueda y reinicia la pila.
Escala el problema si los registros de las rutas antigua y nueva siguen activos a la vez, se vuelve a procesar inesperadamente una biblioteca externa grande o desaparecen las relaciones mientras los originales siguen siendo legibles. Conserva el mapa exacto de montajes antes y después, la versión de Immich, los ID de los recursos afectados, el comportamiento del sistema de archivos con mayúsculas y minúsculas y la marca de tiempo de la copia de seguridad de la base de datos.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



