Páginas

Temas

Herramientas

↑↓moverse↵abriresccerrar
Codificación y seguridad

Estados y códigos de salida

Busca en un solo sitio códigos de estado HTTP, códigos de salida de Docker y Kubernetes y valores errno de red. Cada entrada muestra la causa, el comando para comprobarlo de inmediato y si tiene sentido reintentar.

Se ejecuta por completo en tu navegador: nada de lo que pegues se sube.

Búsqueda rápida
42 códigosCada entrada indica la causa, el comando que conviene ejecutar y si tiene sentido reintentar.
  • 200OKReintento seguroHTTP

    La petición se completó y el cuerpo trae el resultado. Un 200 con el cuerpo vacío suele venir de una caché o de una rama de respaldo.

    • curl -i https://example.com/api/health
    • curl -sS https://example.com/api/health | head -c 200
    • Se puede repetir la misma petición tal cual.
  • 201CreatedNo reintentarHTTP

    La petición creó un recurso. La cabecera Location apunta al registro nuevo y su ausencia es la razón habitual de que el cliente no pueda continuar.

    • curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/items
    • Repetir la misma petición devuelve la misma respuesta.
  • 204No ContentNo reintentarHTTP

    La petición se completó y la respuesta no tiene cuerpo. El código que siempre analiza JSON falla aquí con un final de JSON inesperado.

    • curl -i -X DELETE https://example.com/api/items/42
    • Repetir la misma petición devuelve la misma respuesta.
  • 301Moved PermanentlyReintento seguroHTTP

    La URL cambió de forma permanente y los clientes guardan la redirección en caché. Úsalo solo si la ruta antigua no vuelve; un cambio temporal va en 302 o 307.

    • curl -sSIL https://example.com/old-path
    • Se puede repetir la misma petición tal cual.
  • 302FoundReintento seguroHTTP

    Es una redirección temporal, pero los clientes pueden convertir el POST en GET. Si la API debe conservar el método, usa 307 u 308.

    • curl -sSIL https://example.com/login
    • Se puede repetir la misma petición tal cual.
  • 304Not ModifiedReintento seguroHTTP

    La copia en caché sigue siendo válida, así que no se envía cuerpo. Solo aparece con If-None-Match o If-Modified-Since y en un registro no es un error.

    • curl -i -H 'If-None-Match: "etag"' https://example.com/page
    • Se puede repetir la misma petición tal cual.
  • 307Temporary RedirectReintento seguroHTTP

    Redirección temporal que conserva el método y el cuerpo, justo lo que necesita un POST dirigido a otra URL.

    • curl -sSIL -X POST https://example.com/api/old
    • Se puede repetir la misma petición tal cual.
  • 308Permanent RedirectReintento seguroHTTP

    Redirección permanente que conserva el método y el cuerpo. El navegador la guarda en caché, así que un destino equivocado es difícil de revertir.

    • curl -sSIL https://example.com/old
    • Se puede repetir la misma petición tal cual.
  • 400Bad RequestReintentar tras corregirHTTP

    El servidor no pudo leer la petición: JSON roto, un campo obligatorio ausente o un Content-Type incorrecto. Casi todos los frameworks indican en el cuerpo qué campo falla.

    • curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/items
    • echo '{"name":"test"}' | python3 -m json.tool
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 401UnauthorizedReintentar tras corregirHTTP

    Falta la autenticación o no es válida: no hay cabecera Authorization, el token caducó o el esquema es otro. La cabecera WWW-Authenticate dice qué espera el servidor.

    • curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/me
    • curl -sSI https://example.com/api/me | grep -i www-authenticate
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 403ForbiddenReintentar tras corregirHTTP

    La sesión está autenticada pero no tiene permiso. Revisa el rol o alcance, la política del bucket o la tabla y la lista de IP permitidas; un 403 tras iniciar sesión es un problema de permisos, no de token.

    • curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/admin
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 404Not FoundNo reintentarHTTP

    La ruta o el registro no existe. Revisa la ruta, la barra final, la URL base y el id; un proxy que recorta el prefijo de la ruta da la misma respuesta.

    • curl -sSIL https://example.com/api/items/42
    • curl -sS http://localhost:3000/api
    • Repetir la misma petición devuelve la misma respuesta.
  • 405Method Not AllowedReintentar tras corregirHTTP

    La ruta existe pero no acepta este método: un GET a un endpoint solo POST, o un proxy o formulario que cambió el método. La cabecera Allow dice qué acepta.

    • curl -i -X GET https://example.com/api/items
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 408Request TimeoutReintento seguroHTTP

    El cliente no envió la petición completa a tiempo. Suele ser una subida lenta en una conexión débil o un tiempo de espera del proxy menor que el del cliente.

    • curl -sS -o /dev/null -w '%{time_total}s\n' https://example.com/api/upload
    • Se puede repetir la misma petición tal cual.
  • 409ConflictReintentar tras corregirHTTP

    La petición entra en conflicto con el estado actual: una clave única duplicada, dos escrituras en la misma fila o un desajuste de versión de bloqueo optimista. Conviene releer y reintentar.

    • curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"a@b.c"}' https://example.com/api/users
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 413Payload Too LargeReintentar tras corregirHTTP

    El cuerpo supera un límite del servidor o de lo que hay delante: client_max_body_size de nginx, el tope de una función serverless o el límite del framework. Comprime o sube por partes.

    • du -h ./upload.zip
    • curl -i -F 'file=@upload.zip' https://example.com/api/upload
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 415Unsupported Media TypeReintentar tras corregirHTTP

    El Content-Type no es el que acepta el endpoint. Lo habitual es enviar un cuerpo JSON como formulario; pon application/json y mantén el JSON válido.

    • curl -i -X POST -H 'Content-Type: application/json' -d '{"a":1}' https://example.com/api/items
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 422Unprocessable EntityReintentar tras corregirHTTP

    El formato es correcto pero los valores no pasan la validación. FastAPI, Rails y Laravel devuelven los errores de campo en el cuerpo, así que léelo antes de cambiar la forma de la petición.

    • curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"nope"}' https://example.com/api/users
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 429Too Many RequestsReintento seguroHTTP

    Se alcanzó un límite de peticiones o una cuota. Lee Retry-After, espera con jitter y comprueba qué clave está limitada: una IP, una clave de API o un usuario.

    • curl -sSI https://example.com/api/items | grep -i retry-after
    • sleep 5 && curl -i https://example.com/api/items
    • Se puede repetir la misma petición tal cual.
  • 500Internal Server ErrorReintento seguroHTTP

    El servidor lanzó un error que no controla. La traza está en el registro del servidor y un 500 que solo aparece en una ruta apunta a ese handler, no a la red.

    • curl -i https://example.com/api/items
    • docker compose logs -f --tail 50 api
    • Se puede repetir la misma petición tal cual.
  • 502Bad GatewayReintento seguroHTTP

    El proxy llegó al upstream pero no obtuvo una respuesta usable: la aplicación se cayó o se reinicia, escucha en otro puerto o responde HTTP en un puerto TLS.

    • curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' https://example.com/
    • docker compose ps
    • Se puede repetir la misma petición tal cual.
  • 503Service UnavailableReintento seguroHTTP

    El servidor está en pie pero no puede atender: sobrecarga, mantenimiento, una dependencia que falla o ninguna instancia sana detrás del balanceador. Retry-After indica cuándo volver.

    • curl -sSI https://example.com/ | grep -i retry-after
    • docker compose ps
    • Se puede repetir la misma petición tal cual.
  • 504Gateway TimeoutReintento seguroHTTP

    El proxy esperó al upstream más que su tiempo de espera. Mira las consultas lentas, un índice ausente, proxy_read_timeout o el límite de ejecución de la función antes que el código.

    • curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' http://localhost:3000/api/slow
    • psql "$DATABASE_URL" -c 'EXPLAIN ANALYZE SELECT 1'
    • Se puede repetir la misma petición tal cual.
  • 0Exit 0 — successReintento seguroContenedor y salida

    El proceso terminó con éxito. Es lo esperado en una tarea de una sola vez y un fallo en un servicio que debe seguir vivo, así que revisa si el entrypoint termina y sale.

    • docker logs --tail 50 <container>
    • docker inspect --format '{{.State.ExitCode}}' <container>
    • Se puede repetir la misma petición tal cual.
  • 1Exit 1 — application errorReintentar tras corregirContenedor y salida

    La propia aplicación falló: una excepción no capturada, una aserción fallida o una migración pendiente. El motivo está en las últimas líneas del registro del contenedor.

    • docker logs --tail 100 <container>
    • docker inspect --format '{{.State.ExitCode}}' <container>
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 2Exit 2 — usage errorReintentar tras corregirContenedor y salida

    El comando de shell o la línea de comandos está mal: una opción inválida, un argumento ausente o un archivo ilegible en el script de entrada.

    • docker logs --tail 50 <container>
    • docker run --rm -it --entrypoint sh <image>
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 126Exit 126 — cannot executeReintentar tras corregirContenedor y salida

    El comando existe pero no se puede ejecutar: falta el permiso de ejecución, el shebang tiene saltos de línea de Windows o el intérprete no está en la imagen.

    • docker run --rm -it --entrypoint sh <image> -c 'ls -l /entrypoint.sh'
    • file /path/to/entrypoint.sh
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 127Exit 127 — command not foundReintentar tras corregirContenedor y salida

    El comando no está en el PATH de la imagen: una errata, un paquete que nunca se instaló o un binario que solo existe en otra etapa del build multietapa.

    • docker run --rm -it --entrypoint sh <image> -c 'command -v node'
    • docker run --rm -it --entrypoint sh <image> -c 'echo $PATH'
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 130Exit 130 — SIGINTReintento seguroContenedor y salida

    El proceso se detuvo con Ctrl-C, 128 más la señal 2. Es normal en un contenedor que interrumpiste a mano; si ocurre sin nadie en la terminal, hay que mirar.

    • docker inspect --format '{{.State.ExitCode}}' <container>
    • Se puede repetir la misma petición tal cual.
  • 137Exit 137 — SIGKILL / OOMKilledReintentar tras corregirContenedor y salida

    El contenedor se mató con 128 más la señal 9. Casi siempre lo hace el OOM killer, así que compara el pico de memoria de la aplicación con su límite antes de subirlo.

    • docker inspect --format '{{.State.OOMKilled}}' <container>
    • docker stats --no-stream <container>
    • kubectl describe pod <pod> | grep -i -A2 'Last State'
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 139Exit 139 — SIGSEGVReintentar tras corregirContenedor y salida

    El proceso murió por violación de segmento, 128 más la señal 11. Es habitual con un módulo nativo compilado para otra libc o un ABI de Node o Python distinto.

    • docker logs --tail 100 <container>
    • docker inspect --format '{{.Config.Image}}' <container>
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • 143Exit 143 — SIGTERMReintento seguroContenedor y salida

    El contenedor recibió SIGTERM, 128 más la señal 15, que es la petición normal de parada. Si se repite solo, la aplicación no termina su cierre dentro del plazo.

    • docker inspect --format '{{.Config.StopTimeout}}' <container>
    • docker logs --tail 50 <container>
    • Se puede repetir la misma petición tal cual.
  • CrashLoopBackOffKubernetes CrashLoopBackOffReintentar tras corregirContenedor y salida

    Kubernetes reinicia el contenedor porque termina una y otra vez, y la espera entre intentos crece. La salida del intento anterior explica por qué sale.

    • kubectl logs <pod> --previous --tail 100
    • kubectl describe pod <pod> | grep -i -A5 'Last State'
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • ImagePullBackOffKubernetes ImagePullBackOffReintentar tras corregirContenedor y salida

    La imagen no se puede descargar: una etiqueta que no existe, un registro privado sin imagePullSecrets o un registro que limita las peticiones del nodo.

    • kubectl describe pod <pod> | sed -n '/Events/,$p'
    • kubectl get secret <secret> -o yaml
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • CreateContainerConfigErrorKubernetes CreateContainerConfigErrorReintentar tras corregirContenedor y salida

    El contenedor no se puede crear porque falta algo que referencia: un Secret o ConfigMap, una de sus claves o el volumen que lo contiene.

    • kubectl describe pod <pod> | sed -n '/Events/,$p'
    • kubectl get secret,configmap
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • EvictedKubernetes EvictedReintentar tras corregirContenedor y salida

    El pod fue desalojado porque el nodo se quedó sin memoria, disco o procesos. Los requests y limits que no reflejan el uso real y un nodo sin espacio libre son las causas habituales.

    • kubectl get pod <pod> -o jsonpath='{.status.reason}{"\\n"}{.status.message}{"\\n"}'
    • kubectl describe node <node> | grep -i -A6 'Conditions'
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • ECONNREFUSEDECONNREFUSEDReintento seguroErrno de red

    No hay ningún proceso escuchando en ese host y puerto, o solo escucha en 127.0.0.1. Dentro de Docker el host es el nombre del servicio, no localhost, y el puerto debe ser el del contenedor.

    • nc -vz localhost 3000
    • ss -ltnp | grep 3000
    • docker compose ps
    • Se puede repetir la misma petición tal cual.
  • ECONNRESETECONNRESETReintento seguroErrno de red

    La otra parte cerró la conexión a mitad de la petición: el par se cayó o expiró, un proxy o balanceador cerró una conexión inactiva, o se envió HTTP a un puerto TLS.

    • curl -v https://example.com/api/items
    • curl -v --http1.1 --keepalive-time 30 https://example.com/
    • Se puede repetir la misma petición tal cual.
  • ETIMEDOUTETIMEDOUTReintento seguroErrno de red

    No llegó respuesta a tiempo: enrutamiento, firewall o grupo de seguridad, un host equivocado o un par demasiado lento. Prueba el puerto antes de tocar el código.

    • nc -vz -w 5 <host> 443
    • curl -sS -o /dev/null -w '%{time_connect}s %{time_total}s\n' https://example.com/
    • Se puede repetir la misma petición tal cual.
  • ENOTFOUNDENOTFOUNDReintentar tras corregirErrno de red

    El nombre del host no se resolvió: una errata, un dominio de búsqueda ausente, un contenedor sin DNS o un resolutor que aplica límite de peticiones.

    • getent hosts api.example.com
    • nslookup api.example.com 1.1.1.1
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • EADDRINUSEEADDRINUSEReintentar tras corregirErrno de red

    El puerto ya está ocupado en esta máquina: otro proceso o una instancia anterior que nunca terminó.

    • lsof -i :3000
    • kill -15 $(lsof -t -i :3000)
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.
  • EACCESEACCESReintentar tras corregirErrno de red

    Permiso denegado: un puerto por debajo de 1024 sin privilegios o un archivo o directorio que el proceso no puede escribir. En contenedores suele ser un usuario no root con un volumen propiedad de root.

    • id
    • ls -ld /var/lib/app
    • PORT=8080 node server.js
    • Reintenta cuando la causa esté corregida; repetirla ahora no cambia nada.

Referencia de estados y códigos de salida

referencia rápida
4xx vs 5xx
Un 4xx indica algo que corregir en la petición del cliente y un 5xx un fallo del servidor; un 502 o 504 en una sola ruta casi siempre viene del upstream detrás del proxy.
128 + signal
El shell informa de un proceso terminado por una señal como 128 más el número de señal: 137 es 128+9 (SIGKILL), 143 es 128+15 (SIGTERM) y 139 es 128+11 (SIGSEGV).
OOMKilled
Un 137 con OOMKilled en true en docker inspect significa que se alcanzó el límite de memoria; un límite por debajo del pico de la aplicación la reinicia igual.
CrashLoopBackOff
Kubernetes reinicia el contenedor porque termina una y otra vez; kubectl logs --previous muestra el intento que falló.
ECONNREFUSED
Nada escucha en ese host y puerto; dentro de Docker el host es el nombre del servicio, no localhost, y el puerto es el del contenedor.
Retry-After
Es la cabecera que envía un 429 o un 503 para indicar cuándo volver; espera con jitter en lugar de reintentar en bucle cerrado.

Preguntas frecuentes

respuestas bajo la herramienta
Mi contenedor terminó con 137, ¿qué significa?

137 es 128 + 9, SIGKILL: o lo mató el sistema por falta de memoria o fue un docker stop. docker inspect con OOMKilled los distingue.

¿Qué es CrashLoopBackOff?

Kubernetes reinicia el contenedor porque termina una y otra vez; kubectl logs --previous muestra por qué murió el último intento.

¿Es seguro reintentar un 503?

Sí, con retroceso: suele ser un problema temporal del origen o de capacidad, y Retry-After indica cuánto esperar.

Todas las guías de Linux