Determina si un error de Immich se origina en el cliente o en el servidor repitiendo la misma acción y cambiando una sola variable, y sigue la solicitud fallida a lo largo de la ruta.
Un aviso en el móvil que dice «error del servidor» también puede deberse al estado del cliente, TLS, un proxy inverso o una solicitud que el servidor rechazó correctamente. Del mismo modo, un fallo que solo ocurre en el navegador no demuestra que el navegador esté averiado. Mantén la misma cuenta, el mismo archivo y la misma acción; compara clientes y rutas; luego usa los códigos de estado y los registros sincronizados para localizar la primera capa que falla.
Repite la misma acción en un segundo cliente
Elige una acción reproducible, como iniciar sesión, abrir un archivo conocido, subir la misma foto pequeña o ejecutar la misma búsqueda. Repítela con la misma cuenta en un navegador y en un cliente móvil, sin cambiar la ruta de red. Registra la hora exacta y el resultado de ambos intentos.
Un informe reciente de Immich en el que se probó un cliente de Android que fallaba junto con otras vías de acceso ilustra el valor de comparar varios clientes. La causa de un hilo no es necesariamente generalizable, pero un resultado específico de un cliente permite acotar considerablemente dónde buscar a continuación.
Si todos los clientes fallan al realizar la misma acción en el mismo momento, suben en la lista de posibles causas el servidor, la base de datos, el almacenamiento o una ruta de red compartida. Si solo falla un cliente y otro funciona a través del mismo punto de conexión, comprueba la versión del cliente, el estado almacenado en caché, los permisos, la confianza local en el certificado y la solicitud exacta que difiere.
Cambia la ruta sin cambiar la cuenta ni el archivo
A continuación, compara una ruta local de confianza con la ruta habitual a través de un proxy inverso, una VPN, un túnel o una conexión remota. Usa la misma cuenta y realiza la misma acción. Si funciona localmente pero falla de forma remota, es menos probable que el problema esté en el registro multimedia y más probable que esté en las capas de DNS, TLS, proxy, firewall o enrutamiento al servidor de origen.
La guía de ZimaSpace sobre el diagnóstico de rutas locales y remotas explica por qué el éxito en la LAN y el éxito a través de internet son pruebas distintas. Aplica esa distinción a Immich antes de reinstalar una aplicación móvil o reconstruir el servidor.
Si ambas rutas fallan de la misma manera, deja de cambiar la configuración del proxy e inspecciona la solicitud en la aplicación. Si solo falla la ruta del proxy, registra el estado del proxy, el resultado de TLS, la respuesta del servidor de origen y el tiempo de espera. Esta comparación con una sola variable evita que un mensaje del cliente lleve la investigación por el camino equivocado.
Usa los códigos de estado como pistas, no como veredictos definitivos
Las clases de códigos de estado HTTP ayudan a determinar dónde buscar, pero no identifican automáticamente el componente que causó el problema. Un código 4xx suele indicar que la solicitud, la autenticación o la autorización no eran aceptables; un código 5xx indica que un componente del servidor no pudo completar la solicitud. Los proxies pueden generar cualquiera de las dos clases antes de que Immich reciba la solicitud.
La guía de campos del registro de acceso destaca el código de estado, la ruta URL, el tiempo de solicitud, el host remoto y los identificadores de solicitud como campos útiles para solucionar problemas. Captura esos valores para la acción que falla, en lugar de revisar miles de líneas no relacionadas.
Si el proxy registra un 502 o un tiempo de espera agotado sin una solicitud correspondiente de Immich, sigue la ruta hacia el servidor de origen. Si Immich registra una solicitud y devuelve un 4xx determinista, revisa la autenticación, los permisos o el contenido de la solicitud. Si el cliente indica un fallo, pero todas las capas del servidor muestran un 2xx, revisa el análisis del cliente, la caché local o las solicitudes posteriores.
Correlaciona la tasa de errores, la latencia y los registros del servidor en una misma marca de tiempo
Una solicitud fallida puede ser un caso aislado. Repite la acción de cinco a diez veces y registra la tasa de éxito y la latencia mientras supervisas los registros relevantes del servidor y del proxy. Si los errores aumentan durante una presión sobre los recursos o picos en la cola, es posible que el servidor no esté disponible de forma intermitente, aunque un segundo intento tenga éxito.
La guía de Better Stack sobre los errores y la latencia como indicadores del servicio distingue la tasa de errores de la latencia y el tráfico. Este enfoque ayuda a diferenciar una única solicitud malformada del cliente de una ruta del servidor que se degrada solo bajo carga.
Si los registros del servidor contienen la misma excepción para varios clientes, considera que el problema está en el servidor hasta que se demuestre lo contrario. Si el servidor nunca recibe la solicitud fallida, rastrea DNS, TLS, el proxy y la red del cliente. Si solo un cliente genera una solicitud con un formato distinto, actualiza o restablece ese cliente después de conservar pruebas suficientes para confirmar la diferencia.
Emite el juicio final con una prueba de dos por dos
Usa dos clientes y dos rutas: navegador en local, navegador en remoto, móvil en local y móvil en remoto. Usa la misma cuenta y el mismo recurso de prueba. Esta matriz permite distinguir los fallos específicos del cliente de los específicos de la ruta y de los fallos del servidor que afectan a todas las combinaciones.
La causa está en el cliente si uno falla en ambas rutas mientras otro funciona. La causa está en la ruta si ambos clientes fallan solo en una de ellas. La causa está en el servidor si los cuatro reproducen el mismo error de aplicación y los registros del servidor muestran la misma operación fallida.
Tras corregir la capa identificada, vuelve a ejecutar las cuatro celdas y reinicia una vez el componente afectado. Detente cuando la celda que fallaba originalmente supere la prueba sin que fallen los controles. Escala el problema con la matriz, las marcas de tiempo, los estados HTTP, extractos de los registros del proxy y del servidor, las versiones de los clientes y una solicitud reproducible, en lugar de una captura de pantalla genérica.
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...



