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.
- 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/healthcurl -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/itemsecho '{"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/mecurl -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/42curl -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.zipcurl -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-aftersleep 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/itemsdocker 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-afterdocker 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/slowpsql "$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 100kubectl 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 3000ss -ltnp | grep 3000docker 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/itemscurl -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> 443curl -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.comnslookup 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 :3000kill -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.
idls -ld /var/lib/appPORT=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 herramientaMi 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.
Guías de sintaxis de Linux
Todas las guías de LinuxLinux: Too many open files (EMFILE) and ulimit
EMFILE is a per-process descriptor limit, ENFILE is the kernel's. Read the limit from /proc, raise it in the right layer, and find the leak that made it matter.
Linuxsystemd status=203/EXEC and 217/USER: Exec and Permission Failures
203 is a failed execve, 217 is a user systemd could not resolve. Both happen before your program runs, and the check that finds each takes one command.
Linuxsystemd Timers vs Cron: Missing PATH, Overlapping Runs, Time Drift
Cron runs a bare shell with no profile and no locking, and systemd reads the system time zone. The environment, single-instance and schedule fixes for both.
LinuxBash Indexed Arrays, Associative Maps, and Parameter Expansion
Quoting decides whether an array stays a list, and the expansion operators replace most external text tools. Includes set -u, mapfile, namerefs, and the bash 3.2 differences that break scripts on macOS.