Ir al contenido
Programación

Anda en localhost pero da 502 en el servidor: cómo encontrar el problema en 6 pasos

Autor: Claudio Paredes Arbelo 4 noviembre 2026
Anda en localhost pero da 502 en el servidor: cómo encontrar el problema en 6 pasos

Te pasó: en tu máquina la app anda perfecto, la subís al servidor y el navegador te devuelve un 502 Bad Gateway, un 403 o directamente nada. Y ahí empieza la parte fea: probar cosas al azar, reiniciar servicios, copiar comandos de foros y rezar.

La buena noticia es que casi nunca hace falta saberse todas las soluciones de memoria. Lo que hace falta es un método: recorrer el camino que hace un request, en orden, hasta encontrar dónde se corta.

El camino de un request

Cuando alguien entra a api.tudominio.com, el pedido pasa por estas piezas, de afuera hacia adentro:

DNS → servidor → Nginx → tu app (Laravel con PHP-FPM o Node con PM2) → base de datos.

Diagnosticar es preguntarle a cada pieza, en ese orden: ¿el request llega hasta acá?

Paso 1: ¿el servidor está vivo?

Si no podés entrar por SSH, el problema es el servidor entero: revisá el panel de tu proveedor. Si entrás, mirá el estado general:

uptime     # carga y hace cuánto se reinició
free -h    # memoria disponible
df -h /    # espacio en disco

Un disco al 100% o la memoria agotada explican muchísimos errores "raros".

Paso 2: ¿el DNS apunta bien?

dig api.tudominio.com +short @1.1.1.1

Si no devuelve la IP de tu servidor, no busques más: el problema está en el DNS.

Paso 3: ¿Nginx responde?

sudo nginx -t
curl -I -H "Host: api.tudominio.com" http://127.0.0.1

El segundo comando le pide la app a Nginx desde el propio servidor, salteando DNS y firewall. Si esto funciona y desde afuera no, el problema está antes de Nginx.

Paso 4: ¿tu app responde?

Para Laravel, revisá PHP-FPM y su socket:

sudo systemctl status php8.3-fpm
ls -la /run/php/

Para Node, revisá PM2 y probá el puerto directo:

pm2 status
curl -I http://127.0.0.1:3001

Si el curl directo al puerto funciona pero a través de Nginx da 502, el problema está en la configuración del proxy: un puerto equivocado o un server_name mal escrito.

Paso 5: ¿la app llega a la base?

mysql -u usuario_app -p -e "SELECT 1;" nombre_base

Paso 6: leé el log correcto

En cada paso, el log de esa pieza te dice el motivo exacto: el error.log de Nginx del dominio, el log de Laravel en storage/logs, o pm2 logs para Node. La mitad del trabajo es saber cuál log abrir.

Lo que hay detrás de "anda en mi compu"

Este método resuelve el problema del día. Pero la mayoría de esos errores se evitan si el servidor se arma bien desde el principio: usuarios y SSH seguros, Nginx bien configurado para varias apps, HTTPS con renovación automática, permisos correctos para Laravel, PM2 que levanta Node solo si se cae, backups que se pueden restaurar y un deploy repetible con git push.

Todo eso es lo que cubre Deploy Real: Laravel y Node.js en tu propio VPS, la guía que escribí a partir de los servidores que mantengo en producción. Son 12 capítulos, desde preparar el VPS hasta esta guía de diagnóstico completa, con los comandos y archivos de configuración que necesitás y checklists al final de cada capítulo.

Conocé Deploy Real y descargalo al instante →

Comentarios (0)

Iniciar sesión para dejar un comentario.

Sé el primero en comentar.