Localhost no funciona
Los problemas de localhost casi siempre vienen de cuatro sitios: servicio detenido, puerto incorrecto, protocolo incorrecto o ruta incorrecta.
Checklist rápido
- 1 Comprueba la URL exacta, incluyendo protocolo, host, puerto y ruta.
- 2 Confirma que el servidor local sigue ejecutándose en la terminal o gestor de servicios.
- 3 Prueba la versión con IP de loopback, como http://127.0.0.1:3000/.
- 4 Comprueba si otro proceso ya está usando el puerto.
- 5 Lee el error de la terminal antes de cambiar firewall, navegador o código.
Comprobaciones rápidas
curl -I http://127.0.0.1:PORT/Si la IP numérica funciona y localhost no, revisa hosts, IPv6, bind address o certificados.
lsof -i :PORTSepara un problema del navegador de un servidor ausente o conflicto de puerto. Cambia PORT por 3000, 5173, 8000 o el de tu terminal.
http://localhost:PORT/pathMuchos fallos vienen de copiar un puerto o ruta de un tutorial en vez de la salida actual del proyecto.
Comprobación de request en vivo
Qué ve esta página
Headers HTTP de la request
Los headers sensibles, como cookies y tokens de autorización, se filtran antes de mostrarse.
Lee primero el tipo de error
Conexión rechazada, no se puede acceder, error SSL y páginas 404 apuntan a soluciones distintas. No los trates igual.
La terminal es la fuente de verdad
La mayoría de dev servers imprime la URL local exacta. Copia esa línea antes de adivinar el puerto.
Mapa rápido de errores
Clasifica el mensaje del navegador antes de cambiar código. Así no tocas firewall cuando el problema era un servidor detenido.
- ERR_CONNECTION_REFUSED: nada aceptó la conexión en ese host y puerto.
- 404 not found: hay servidor, pero la ruta no existe.
- SSL protocol error: el navegador probablemente usó https contra un servicio http.
- Pantalla en blanco: el frontend cargó, pero datos, variables o API pueden fallar.
Guías relacionadas de localhost
Localhost se negó a conectar
Soluciona localhost se negó a conectar revisando proceso, URL, puerto, protocolo, firewall y logs locales.
Comparaciónlocalhost vs 127.0.0.1
Compara localhost y 127.0.0.1, entiende direcciones loopback y aprende cuándo una funciona y la otra falla.
Guía de escrituraCorrector de errores localhost
Corrige errores comunes como locallhost, localhos, lcoalhost, localhost.com, http localhost y https localhost.
Herramienta para developersConstructor de URL localhost
Crea URLs localhost con protocolo, host, puerto y ruta correctos; compara localhost, 127.0.0.1 e IP LAN.
FAQ
¿Por qué localhost funciona en un proyecto y en otro no?
Cada proyecto puede usar otro puerto, framework, ruta o protocolo. Revisa la terminal del proyecto activo.
¿Por qué localhost.com no funciona igual que localhost?
localhost es un nombre local especial. Un dominio público parecido no es lo mismo que la dirección loopback de tu ordenador.
¿Qué significa localhost no abre?
Puede significar servidor detenido, puerto equivocado, ruta 404 o protocolo incorrecto. Mira el mensaje exacto del navegador.
¿Conexión rechazada es lo mismo que 404?
No. Conexión rechazada significa que nada aceptó la conexión en ese host y puerto. Un 404 significa que un servidor respondió, pero la ruta falta.
¿Debo cambiar el firewall primero?
Normalmente no. Primero confirma que el proceso está arrancado, el puerto es correcto y el protocolo coincide. Firewall importa más al acceder desde otro dispositivo.
¿Cómo sé si el problema es navegador o servidor?
Prueba la misma URL con 127.0.0.1, revisa la terminal y usa lsof -i :PORT. Si nada escucha, el problema está del lado servidor.