Cómo usar la referencia
- Escriba un código o una palabra clave: 404, 5xx, redirect, rate limit o cloudflare.
- Filtre por clase: información, éxito, redirección, error del cliente o error del servidor.
- Active los códigos no oficiales si busca códigos de nginx o Cloudflare.
- Lea el significado y las causas y soluciones habituales.
- Use los atajos para los códigos más consultados.
Las cinco clases de códigos
| Clase | Significado | Ejemplos |
|---|---|---|
| 1xx | información: la petición sigue en curso | 100 Continue, 101 Switching Protocols |
| 2xx | éxito | 200 OK, 201 Created, 204 No Content |
| 3xx | redirección | 301, 302, 304 Not Modified |
| 4xx | error del cliente: la petición es incorrecta | 400, 401, 403, 404, 429 |
| 5xx | error del servidor: la petición era correcta, pero el servidor falló | 500, 502, 503, 504 |
Los nombres oficiales, como «Not Found» o «Bad Gateway», se muestran en inglés tal como los define el estándar y como aparecen en los registros y las herramientas de desarrollo del navegador.
Los códigos más importantes en la práctica
- 301 y 308: redirección permanente. Para el cambio a HTTPS, URL antiguas o un dominio nuevo; transmiten el valor SEO.
- 302 y 307: redirección temporal. Los buscadores mantienen indexada la URL original.
- 401 frente a 403: 401 significa «no autenticado» (falta el inicio de sesión o ha caducado); 403, «autenticado pero sin permiso».
- 404 frente a 410: 404 «no encontrado», 410 «eliminado definitivamente»; Google retira antes las páginas 410.
- 429: demasiadas peticiones; respete la cabecera Retry-After.
- 500: error genérico del servidor; la respuesta está en los registros del servidor.
- 502 y 504: problemas entre el proxy y el servidor de aplicaciones, como un PHP-FPM caído o una base de datos lenta.
- 503: no disponible temporalmente, por mantenimiento o sobrecarga.
Códigos de estado y SEO
Para los buscadores, los códigos de estado son señales importantes. Las páginas que devuelven 404 o 410 desaparecen del índice con el tiempo. Una página de error que responde con 200, el llamado «soft 404», confunde a Google y desperdicia presupuesto de rastreo. Las redirecciones 301 transfieren la autoridad de la URL antigua a la nueva, mientras que las cadenas de varias redirecciones ralentizan el rastreo. Los errores 5xx prolongados hacen que Google rastree con menos frecuencia y, a la larga, retire páginas. Revise el informe de indexación de Google Search Console con regularidad.
Códigos no oficiales de nginx y Cloudflare
Algunos servidores y CDN usan códigos propios. nginx devuelve 499 cuando el cliente cerró la conexión antes de recibir la respuesta, y 444 para cerrar conexiones sin responder. Cloudflare usa la serie 52x: 521 indica que el servidor de origen rechaza la conexión, 522 que la conexión agotó el tiempo y 524 que el origen tardó más de 100 segundos en responder. Active «Incluir códigos no oficiales» para verlos.
Un ejemplo
Su tienda en línea muestra de repente «502 Bad Gateway». La referencia explica que el proxy, por ejemplo nginx, recibió una respuesta no válida del servidor de aplicaciones. Causas habituales: PHP-FPM se ha caído, se está reiniciando o ha agotado sus procesos. Revise el registro de errores de nginx y el estado del servicio PHP. Si ve un 504, el servidor de aplicaciones respondió demasiado tarde, normalmente por una consulta lenta a la base de datos.
Preguntas frecuentes
¿Cuál es la diferencia entre 301 y 302?
301 es permanente y transmite el valor SEO; 302 es temporal y la URL original sigue indexada.
¿Qué significa el error 500?
Un error genérico del servidor. La causa exacta aparece en los registros de errores del servidor.
¿Por qué recibo un 403?
No tiene permiso: por permisos de archivos, una IP bloqueada, una regla del cortafuegos o falta de derechos.
¿Qué hago con un 429?
Reduzca el ritmo de peticiones, respete Retry-After y añada caché o reintentos espaciados.
¿Qué es el código 418?
«I’m a teapot», una broma del 1 de abril de 1998 que algunos servidores usan para rechazar bots.