¿Por qué Immich devuelve errores intermitentes durante las importaciones grandes de bibliotecas móviles?

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Los errores intermitentes de Immich durante una importación grande desde un dispositivo móvil suelen indicar que una capa está fallando bajo una carga simultánea, no que toda la biblioteca o todos los archivos cargados estén dañados.

Las importaciones grandes combinan el comportamiento en segundo plano de los dispositivos móviles, las solicitudes de larga duración, los límites de los proxies inversos o túneles, las escrituras en la base de datos, la E/S del almacenamiento, el procesamiento de miniaturas y vídeos, y las colas de aprendizaje automático. Primero, registra un grupo pequeño de archivos que hayan fallado y sus marcas de tiempo. Después, determina si el fallo empieza en el teléfono, la ruta de red, el servidor de la aplicación o una dependencia saturada.

Clasifica el grupo de errores antes de reintentarlo todo

Agrupa los fallos por tipo de medio, tamaño del archivo, dispositivo de origen, ruta de red y hora. Si solo fallan los vídeos grandes, investiga la duración de las solicitudes y los límites de carga antes de centrarte en la CPU. Si fallan fotos y vídeos aleatorios durante los mismos intervalos de mayor actividad, los recursos compartidos del servidor o la inestabilidad de la red son causas más probables.

Un informe de usuario de Immich de 2026 que describe numerosos errores de carga desde dispositivos móviles resulta útil porque muestra cómo una gran acumulación de archivos en el teléfono puede dar lugar a fallos repetidos que requieren un diagnóstico por elemento y por ruta. No demuestra que haya un único error universal en la aplicación móvil.

No selecciones «reintentar todo» como primera acción de diagnóstico. Guarda los nombres o ID de diez archivos que hayan fallado, un elemento de control que haya funcionado y el intervalo correspondiente de los registros del cliente y el servidor. Un grupo pequeño y conocido te permite probar cambios sin generar una nueva avalancha que oculte las pistas originales.

Compara las cargas locales con la ruta remota habitual

Sube los mismos archivos de prueba, pequeños y grandes, mediante una red wifi local estable, directamente al punto de conexión local de confianza; luego repite la prueba a través del nombre de host remoto, la VPN, el túnel o el proxy inverso habituales. Mantén la misma cuenta y el mismo archivo para que la ruta sea la principal variable.

Un informe sobre fallos al hacer copias de seguridad de archivos grandes destaca por qué los límites de solicitudes del proxy o túnel son relevantes en este caso. El servicio y los umbrales indicados dependen de cada implementación; la prueba general consiste en comprobar si la transferencia local directa funciona mientras la ruta remota falla de forma sistemática.

Si ambas rutas fallan con los mismos archivos, sigue las pistas del servidor y el almacenamiento. Si solo falla la ruta remota, revisa el tamaño máximo del cuerpo, el almacenamiento en búfer de las solicitudes, los tiempos de espera de inactividad y lectura, la terminación TLS, los cambios de red móvil y las retransmisiones. Cambiar la concurrencia de las miniaturas no solucionará una solicitud que nunca llega completa a Immich.

Correlaciona los errores con el crecimiento de la cola y la presión sobre los recursos

Las importaciones grandes pueden seguir aceptando cargas mientras se acumulan los trabajos en segundo plano. Observa la CPU, la presión de memoria, la latencia de E/S de bloques, la capacidad de respuesta de la base de datos, los reinicios de contenedores y la finalización de trabajos durante el periodo de fallo. Un uso elevado por sí solo no es una prueba; la métrica debe cambiar al mismo tiempo que se producen los errores.

El artículo sobre la supervisión de recursos de Docker, que trata sobre las métricas de CPU, memoria, red y disco de los contenedores, muestra la utilidad de comparar contenedores en lugar de fijarse en un único promedio de todo el host. En Linux, combina las métricas de los contenedores con datos del almacenamiento del host y de la presión de memoria correspondientes a las mismas marcas de tiempo.

Si la presión de memoria provoca el cierre de contenedores, la latencia del almacenamiento aumenta junto con los errores de carga o el tiempo de respuesta de la base de datos se dispara mientras la cola deja de avanzar, reduce únicamente la carga de trabajo o la concurrencia responsable y repite la prueba con el grupo fijo. Si los gráficos de recursos se mantienen estables, continúa con los registros de la aplicación y el diagnóstico de la ruta de red.

Considera la tasa de errores y la latencia de cola larga como indicadores de carga

Un sistema puede parecer saludable según el tiempo de respuesta promedio, aunque un pequeño porcentaje de solicitudes agote el tiempo de espera durante los picos. Registra el número de cargas intentadas, los fallos, el tiempo de respuesta mediano y las solicitudes más lentas durante un periodo controlado. Así, lo «intermitente» se puede medir en lugar de basarse en anécdotas.

El marco de pruebas de carga para analizar errores y latencia recomienda examinar las clases de estado, los problemas de conexión, las distribuciones y las correlaciones en series temporales. No hace falta someter a una prueba de estrés la biblioteca familiar; aplica la misma estructura de análisis a la tasa de importación real.

Si reducir considerablemente la tasa de llegada disminuye los fallos y todos los archivos individuales se procesan correctamente, la pila actual no tiene suficiente margen para esa intensidad de importación. Si los mismos archivos fallan incluso de uno en uno, el problema es específico del archivo, de la ruta o un error de software determinista, no una saturación general.

Reduce una fuente de presión y vuelve a probar el mismo patrón de importación

Elige el cambio más seguro según las pruebas: reduce la concurrencia en segundo plano en una unidad, pausa otro contenedor con mucha carga, usa la ruta local, programa la importación fuera del periodo de copia de seguridad o corrige el tiempo de espera del proxy. No cambies a la vez los límites de CPU, el almacenamiento, las reglas del proxy y las versiones de la aplicación.

El flujo de trabajo de ZimaSpace para las interrupciones de la copia de seguridad de fotos del teléfono ofrece la rama de diagnóstico del dispositivo móvil: la programación en segundo plano, los originales disponibles solo en la nube y los cambios en las condiciones de red pueden interrumpir las cargas incluso cuando el servidor funciona correctamente.

Continúa si el grupo fijo se completa correctamente y la misma importación más grande se ejecuta con una tasa de errores estable, las colas avanzan y el rendimiento interactivo es aceptable. Escala el problema si los fallos persisten con poca carga o se repiten con los mismos archivos; incluye los registros del cliente y del servidor, el estado del proxy, los gráficos de recursos, el tipo y el tamaño de archivo, y la primera solicitud que falla.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.