Immich muestra datos obsoletos después de cambiar la ruta de almacenamiento

Los datos obsoletos de Immich después de cambiar una ruta de almacenamiento tienen tres causas diferentes que no deben mezclarse: un cambio de la raíz de medios administrados, un cambio de la ruta de importación de una biblioteca externa o un cliente que aún muestra un estado en caché. Las versiones modernas de Immich pueden conciliar una ubicación de medios administrados trasladada cuando la ubicación de medios configurada y el montaje del volumen se mantienen coherentes, mientras que los cambios de ubicación 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 escanear. Primero demuestra qué ruta ve el contenedor en ejecución y luego identifica si el registro del servidor de Immich es incorrecto o si solo un cliente está obsoleto. Esa distinción determina si debes reparar un montaje, restaurar una ruta estable visible para el contenedor, volver a escanear un subconjunto de prueba o borrar únicamente la caché del cliente.

Distingue un cambio de la raíz de medios administrados de un cambio de biblioteca externa

Si cambiaste la ubicación del host para las cargas administradas por Immich, verifica que la configuración efectiva de la ubicación de medios y el montaje del host al contenedor hayan cambiado conjuntamente. Un cambio moderno de medios administrados no debe diagnosticarse de la misma forma que el 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 único límite de recuperación. No basta con que los archivos correctos estén en el host si el contenedor está montado en otro lugar.

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 trabajos de biblioteca. Si la ruta modificada pertenece a una biblioteca externa, conserva intacta la base de datos y prueba esa rama por separado.

Mantén estable la ruta del contenedor de la biblioteca externa cuando sea posible

Para una biblioteca externa, el traslado del almacenamiento en el host es más seguro cuando la ruta de importación visible para el contenedor puede permanecer sin cambios. 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 escanear, para poder determinar si los recursos existentes se volvieron a vincular o se recrearon.

Un informe sobre un cambio de ruta de biblioteca externa de Immich describió archivos reubicados que se trataron como recursos nuevos, con reprocesamiento y pérdida de relaciones exclusivas de Immich. Es un caso específico de una versión, pero respalda la regla conservadora de que un cambio de ruta de una biblioteca externa no es automáticamente un cambio de nombre transparente.

Si un subconjunto de prueba aparece como recursos nuevos mientras los registros antiguos pasan a estar ausentes o a la papelera, detén el escaneo completo. Restaura la ruta antigua visible para el contenedor si resulta práctico o utiliza un método de migración adecuado para tu versión; no reescribas manualmente las rutas de la base de datos de producción sin una copia de seguridad probada.

No confundas esta rama con una migración de la plantilla de almacenamiento para archivos administrados por Immich. El síntoma puede parecerse en la línea de tiempo, pero la propiedad de los archivos y la ruta de migración compatible son diferentes.

Separa 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áralo con los registros del servidor o con la ruta visible para el servidor. Si los trabajos del servidor aún indican la ruta antigua, borrar la caché del navegador no puede reparar el registro subyacente.

Un problema posterior de metadatos de una ruta antigua de Immich mostró que el procesamiento seguía haciendo referencia a una ruta anterior de biblioteca externa después de un cambio de nombre. Esto demuestra claramente que se deben comprobar las rutas de los trabajos antes de culpar a la interfaz móvil o web.

Si la ruta del servidor es correcta pero solo una vista web está obsoleta, 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 reparado parezca defectuoso, mientras que una vista previa en caché también puede hacer que una ruta del servidor defectuosa parezca correcta.

-15% OFF

ZimaBoard 2 - Mini servidor doméstico para tu gran idea

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Repara el límite de ruta más pequeño y valida un escaneo controlado

Haz una única corrección reversible: sincroniza la configuración de medios administrados y el montaje, restaura la ruta anterior de la biblioteca externa, 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 una biblioteca grande vuelva a descubrirse.

Ejecuta el escaneo más pequeño que resulte práctico y observa si los registros existentes siguen asociados, si cesan los errores de la ruta antigua y si no aparecen recursos antiguos y nuevos duplicados. Después, abre originales de muestra, verifica las relaciones de álbumes y personas, ejecuta una búsqueda y reinicia la pila.

Escala el problema si los registros de las rutas antigua y nueva siguen activos al mismo tiempo, si una biblioteca externa grande se reprocesa inesperadamente o si desaparecen relaciones mientras los originales siguen siendo legibles. Conserva el mapa exacto de montajes anterior y posterior, la versión de Immich, los ID de los recursos afectados, el comportamiento de mayúsculas y minúsculas del sistema de archivos y la marca de tiempo de la copia de seguridad de la base de datos.