Un proxy inverso devuelve un 502 después de reconstruir un contenedor cuando ya no puede abrir una conexión válida con el upstream reconstruido.
La reconstrucción puede reemplazar el contenedor, asignarle una dirección nueva, desconectar o renombrar una red Docker, cambiar el puerto expuesto, restaurar una configuración incompleta o iniciar el proxy antes de que la aplicación esté lista. El diagnóstico correcto comienza con el registro de errores del proxy y sigue la dirección exacta del upstream desde el proxy hasta el contenedor, en lugar de reiniciar ambos servicios hasta que el error desaparezca temporalmente.
Confirma que el 502 se debe a un fallo de conexión con el upstream
Solicita una vez el dominio afectado y registra la marca de tiempo, el estado del proxy, la dirección del upstream y el mensaje de error completo. Distingue entre conexión rechazada, host no encontrado, tiempo de espera agotado, conexión restablecida, fallo en el protocolo de enlace TLS y respuesta no válida.
Un 502 significa que el proxy no recibió una respuesta válida del upstream, pero el detalle del error determina si el destino no existía, era inaccesible, no estaba escuchando o utilizaba el protocolo equivocado. Una guía actual de resolución de problemas de NGINX señala que un contenedor reconstruido puede hacer que el proxy siga usando una dirección de backend antigua hasta que se actualice la resolución de nombres o la configuración.
Prueba la aplicación directamente desde el host del proxy o el contenedor del proxy usando el nombre, la dirección, el puerto y el protocolo del upstream que aparecen en el registro. Si esa solicitud directa falla de la misma manera, centra la investigación entre el proxy y el contenedor, en lugar de cambiar el DNS público o los certificados.
Compara el destino del upstream antes y después de la reconstrucción
Inspecciona el nombre del contenedor reconstruido, el nombre del servicio, la IP interna, el puerto expuesto, el puerto publicado, los alias de red y las redes a las que está conectado. Compáralos con la configuración del proxy y su último destino funcional.
Un problema de nginx-proxy describe una reconstrucción que cambió la IP del contenedor de la aplicación mientras el proxy seguía enviando solicitudes al upstream del contenedor inaccesible. El dominio público seguía siendo correcto mientras solo cambiaba la identidad del upstream privado.
Prefiere un nombre de servicio estable de Compose o un alias de red en lugar de una IP de contenedor. Si la IP está fijada intencionalmente, verifica que el servicio reconstruido realmente la haya recibido y que ningún otro contenedor ocupe ahora esa dirección.
Verifica que el proxy y la aplicación sigan compartiendo una red Docker
Enumera las redes conectadas al proxy y a la aplicación y confirma que comparten al menos una red definida por el usuario. Publicar un puerto del host no hace que el nombre del contenedor sea automáticamente accesible desde otra red Docker aislada.
Un caso de redes de Docker reveló que trasladar un servicio dependiente a la red adecuada eliminó de inmediato los errores 502 recurrentes, lo que demuestra que puede haber una ruta inaccesible al servicio anterior aunque todos los contenedores sigan en ejecución.
Conecta los servicios mediante Compose en lugar de usar comandos puntuales, para que la relación se mantenga tras las reconstrucciones. Prueba la resolución DNS y el puerto del servicio anterior desde el contenedor del proxy después de volver a crear la pila.
Comprueba el puerto de escucha interno y la dirección de enlace
Confirma que la aplicación escucha en el puerto que usa el proxy y en una dirección accesible desde la red de contenedores. No confundas un puerto publicado en el host con el puerto interno en el que escucha el contenedor.
El proxy solo puede conectarse cuando la aplicación escucha en una interfaz distinta de loopback. Un servicio que escucha en 127.0.0.1 dentro de su propio contenedor no está disponible para el proxy, aunque una comprobación local de estado se complete correctamente.
Inspecciona el registro de la aplicación, la lista de sockets y una solicitud directa desde el contenedor del proxy. Si el puerto rechaza las conexiones, corrige el servicio de escucha o la configuración de la aplicación antes de añadir reintentos o aumentar los tiempos de espera del proxy.
Espera a que la aplicación esté lista en vez de confiar en el inicio del contenedor
Un contenedor reconstruido puede estar en ejecución mientras las migraciones, la recuperación de la base de datos, el calentamiento de la caché o la generación de la configuración impiden que la aplicación acepte solicitudes. Compara la hora del primer error 502 con el estado de salud y los registros de inicio.
Un debate sobre la resolución de problemas de Grist muestra cómo la arquitectura de Docker, la configuración del entorno y la disponibilidad del servicio anterior pueden combinarse y causar errores 502 persistentes del lado del contenedor tras una reconstrucción.
Añade una comprobación de estado significativa y haz que el proxy o los servicios dependientes esperen a que se complete la operación que necesitan los clientes, no solo a que exista un proceso. Limita los reintentos para que una aplicación que ha fallado permanentemente no parezca estar iniciándose con lentitud.
Actualiza la resolución del proxy y reconstruye la ruta estable
Recarga o vuelve a crear el proxy cuando el nombre del servicio, la red, el puerto y el estado de salud sean correctos. Si el proxy solo resuelve nombres durante el inicio, configura la resolución dinámica admitida o un orden de reinicio predecible.
El flujo de trabajo de ZimaSpace para aislar una dependencia de contenedor que falla ofrece el diagnóstico complementario cuando el servicio anterior se cierra repetidamente en vez de mantenerse en buen estado.
La reparación solo está completa cuando, tras otra reconstrucción, el proxy resuelve el nombre del servicio, llega al puerto interno previsto, espera durante el inicio y sirve el dominio sin cambios manuales en la IP. Elimina los destinos temporales de IP directa y las conexiones de red no documentadas después de la validación.
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...



