Statuts et codes de sortie
Cherche au même endroit les codes de statut HTTP, les codes de sortie de Docker et de Kubernetes et les valeurs errno réseau. Chaque entrée donne la cause, la commande à lancer tout de suite et l'intérêt d'une nouvelle tentative.
S'exécute entièrement dans votre navigateur : rien de ce que vous collez n'est téléversé.
- 200OKNouvelle tentative possibleHTTP
La requête a réussi et le corps contient le résultat. Un 200 au corps vide vient souvent d'un cache ou d'une branche de repli.
curl -i https://example.com/api/healthcurl -sS https://example.com/api/health | head -c 200- La même requête peut être renvoyée telle quelle.
- 201CreatedNe pas réessayerHTTP
La requête a créé une ressource. L'en-tête Location pointe vers le nouvel enregistrement, et son absence empêche souvent le client d'enchaîner.
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/items- Répéter la même requête donne la même réponse.
- 204No ContentNe pas réessayerHTTP
La requête a réussi et la réponse n'a pas de corps. Un code qui analyse toujours du JSON échoue ici sur une fin de JSON inattendue.
curl -i -X DELETE https://example.com/api/items/42- Répéter la même requête donne la même réponse.
- 301Moved PermanentlyNouvelle tentative possibleHTTP
L'URL a changé définitivement et les clients mettent la redirection en cache. À réserver aux chemins qui ne reviennent pas ; un déplacement temporaire se fait en 302 ou 307.
curl -sSIL https://example.com/old-path- La même requête peut être renvoyée telle quelle.
- 302FoundNouvelle tentative possibleHTTP
Redirection temporaire, mais des clients transforment le POST en GET. Si l'API doit garder la méthode, utilisez 307 ou 308.
curl -sSIL https://example.com/login- La même requête peut être renvoyée telle quelle.
- 304Not ModifiedNouvelle tentative possibleHTTP
La copie en cache est encore valide, donc aucun corps n'est envoyé. Elle n'apparaît qu'avec If-None-Match ou If-Modified-Since et, dans un journal, ce n'est pas une erreur.
curl -i -H 'If-None-Match: "etag"' https://example.com/page- La même requête peut être renvoyée telle quelle.
- 307Temporary RedirectNouvelle tentative possibleHTTP
Redirection temporaire qui conserve la méthode et le corps, exactement ce dont un POST redirigé a besoin.
curl -sSIL -X POST https://example.com/api/old- La même requête peut être renvoyée telle quelle.
- 308Permanent RedirectNouvelle tentative possibleHTTP
Redirection permanente qui conserve la méthode et le corps. Le navigateur la met en cache, une cible erronée est donc difficile à corriger.
curl -sSIL https://example.com/old- La même requête peut être renvoyée telle quelle.
- 400Bad RequestRéessayer après correctionHTTP
Le serveur n'a pas pu lire la requête : JSON cassé, champ obligatoire manquant ou Content-Type incorrect. La plupart des frameworks indiquent dans le corps le champ fautif.
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/itemsecho '{"name":"test"}' | python3 -m json.tool- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 401UnauthorizedRéessayer après correctionHTTP
L'authentification manque ou est invalide : pas d'en-tête Authorization, jeton expiré ou mauvais schéma. L'en-tête WWW-Authenticate indique ce que le serveur attend.
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/mecurl -sSI https://example.com/api/me | grep -i www-authenticate- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 403ForbiddenRéessayer après correctionHTTP
La session est authentifiée mais n'a pas le droit. Vérifiez le rôle ou la portée, la politique du bucket ou de la table et la liste d'IP autorisées ; un 403 après connexion relève des droits, pas du jeton.
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/admin- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 404Not FoundNe pas réessayerHTTP
Le chemin ou l'enregistrement n'existe pas. Vérifiez la route, la barre finale, l'URL de base et l'id ; un proxy qui retire un préfixe donne la même réponse.
curl -sSIL https://example.com/api/items/42curl -sS http://localhost:3000/api- Répéter la même requête donne la même réponse.
- 405Method Not AllowedRéessayer après correctionHTTP
La route existe mais pas pour cette méthode : un GET sur un point d'entrée réservé au POST, ou un proxy ou formulaire qui a changé la méthode. L'en-tête Allow liste ce qui est accepté.
curl -i -X GET https://example.com/api/items- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 408Request TimeoutNouvelle tentative possibleHTTP
Le client n'a pas envoyé la requête entière à temps. En général un envoi lent sur une liaison faible ou un délai du proxy plus court que le besoin du client.
curl -sS -o /dev/null -w '%{time_total}s\n' https://example.com/api/upload- La même requête peut être renvoyée telle quelle.
- 409ConflictRéessayer après correctionHTTP
La requête entre en conflit avec l'état actuel : clé unique en double, deux écritures sur la même ligne ou version de verrouillage optimiste différente. Relire puis réessayer est utile.
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"a@b.c"}' https://example.com/api/users- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 413Payload Too LargeRéessayer après correctionHTTP
Le corps dépasse une limite du serveur ou de ce qui le précède : client_max_body_size de nginx, plafond d'une fonction serverless ou limite du framework. Compressez ou envoyez par morceaux.
du -h ./upload.zipcurl -i -F 'file=@upload.zip' https://example.com/api/upload- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 415Unsupported Media TypeRéessayer après correctionHTTP
Le Content-Type n'est pas celui attendu. Le cas courant est un corps JSON envoyé comme formulaire ; mettez application/json et gardez le JSON valide.
curl -i -X POST -H 'Content-Type: application/json' -d '{"a":1}' https://example.com/api/items- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 422Unprocessable EntityRéessayer après correctionHTTP
Le format est correct mais les valeurs échouent à la validation. FastAPI, Rails et Laravel renvoient les erreurs de champ dans le corps, lisez-les avant de modifier la requête.
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"nope"}' https://example.com/api/users- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 429Too Many RequestsNouvelle tentative possibleHTTP
Une limite de débit ou un quota est atteint. Lisez Retry-After, attendez avec un peu d'aléa et voyez quelle clé est limitée : IP, clé d'API ou utilisateur connecté.
curl -sSI https://example.com/api/items | grep -i retry-aftersleep 5 && curl -i https://example.com/api/items- La même requête peut être renvoyée telle quelle.
- 500Internal Server ErrorNouvelle tentative possibleHTTP
Le serveur a levé une erreur non gérée. La trace est dans le journal du serveur, et un 500 sur une seule route désigne ce gestionnaire, pas le réseau.
curl -i https://example.com/api/itemsdocker compose logs -f --tail 50 api- La même requête peut être renvoyée telle quelle.
- 502Bad GatewayNouvelle tentative possibleHTTP
Le proxy a joint l'amont mais n'a pas obtenu de réponse exploitable : l'application a planté ou redémarre, écoute sur un autre port ou répond en HTTP sur un port TLS.
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' https://example.com/docker compose ps- La même requête peut être renvoyée telle quelle.
- 503Service UnavailableNouvelle tentative possibleHTTP
Le serveur tourne mais ne peut pas servir : surcharge, maintenance, dépendance en échec ou aucune instance saine derrière le répartiteur. Retry-After indique quand revenir.
curl -sSI https://example.com/ | grep -i retry-afterdocker compose ps- La même requête peut être renvoyée telle quelle.
- 504Gateway TimeoutNouvelle tentative possibleHTTP
Le proxy a attendu l'amont plus que son délai. Regardez les requêtes lentes, un index manquant, proxy_read_timeout ou la limite d'exécution de la fonction avant le code.
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' http://localhost:3000/api/slowpsql "$DATABASE_URL" -c 'EXPLAIN ANALYZE SELECT 1'- La même requête peut être renvoyée telle quelle.
- 0Exit 0 — successNouvelle tentative possibleConteneur et sortie
Le processus s'est terminé correctement. Normal pour une tâche unique, anormal pour un service qui doit rester en marche : vérifiez que l'entrypoint finit son travail puis s'arrête.
docker logs --tail 50 <container>docker inspect --format '{{.State.ExitCode}}' <container>- La même requête peut être renvoyée telle quelle.
- 1Exit 1 — application errorRéessayer après correctionConteneur et sortie
L'application a échoué : exception non interceptée, assertion en échec ou migration absente. La raison est dans les dernières lignes du journal du conteneur.
docker logs --tail 100 <container>docker inspect --format '{{.State.ExitCode}}' <container>- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 2Exit 2 — usage errorRéessayer après correctionConteneur et sortie
La commande shell ou la ligne de commande est erronée : option invalide, argument manquant ou fichier illisible dans le script d'entrée.
docker logs --tail 50 <container>docker run --rm -it --entrypoint sh <image>- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 126Exit 126 — cannot executeRéessayer après correctionConteneur et sortie
La commande existe mais ne peut pas s'exécuter : droit d'exécution absent, le shebang contient des fins de ligne Windows ou l'interpréteur n'est pas dans l'image.
docker run --rm -it --entrypoint sh <image> -c 'ls -l /entrypoint.sh'file /path/to/entrypoint.sh- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 127Exit 127 — command not foundRéessayer après correctionConteneur et sortie
La commande n'est pas dans le PATH de l'image : faute de frappe, paquet jamais installé ou binaire présent seulement dans une autre étape du build multi-étapes.
docker run --rm -it --entrypoint sh <image> -c 'command -v node'docker run --rm -it --entrypoint sh <image> -c 'echo $PATH'- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 130Exit 130 — SIGINTNouvelle tentative possibleConteneur et sortie
Le processus s'est arrêté sur Ctrl-C, 128 plus le signal 2. Normal pour un conteneur interrompu à la main ; si cela arrive sans personne au terminal, il faut regarder.
docker inspect --format '{{.State.ExitCode}}' <container>- La même requête peut être renvoyée telle quelle.
- 137Exit 137 — SIGKILL / OOMKilledRéessayer après correctionConteneur et sortie
Le conteneur a été tué par 128 plus le signal 9. Le plus souvent l'OOM killer est passé : comparez le pic de mémoire de l'application avec sa limite avant de l'augmenter.
docker inspect --format '{{.State.OOMKilled}}' <container>docker stats --no-stream <container>kubectl describe pod <pod> | grep -i -A2 'Last State'- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 139Exit 139 — SIGSEGVRéessayer après correctionConteneur et sortie
Le processus a planté sur une erreur de segmentation, 128 plus le signal 11. Fréquent avec un module natif compilé pour une autre libc ou une ABI Node ou Python différente.
docker logs --tail 100 <container>docker inspect --format '{{.Config.Image}}' <container>- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- 143Exit 143 — SIGTERMNouvelle tentative possibleConteneur et sortie
Le conteneur a reçu SIGTERM, 128 plus le signal 15, la demande d'arrêt normale. Si cela se répète seul, l'application ne termine pas son arrêt dans le délai.
docker inspect --format '{{.Config.StopTimeout}}' <container>docker logs --tail 50 <container>- La même requête peut être renvoyée telle quelle.
- CrashLoopBackOffKubernetes CrashLoopBackOffRéessayer après correctionConteneur et sortie
Kubernetes redémarre le conteneur parce qu'il se termine sans cesse, et l'attente entre les tentatives augmente. La sortie de la tentative précédente explique l'arrêt.
kubectl logs <pod> --previous --tail 100kubectl describe pod <pod> | grep -i -A5 'Last State'- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- ImagePullBackOffKubernetes ImagePullBackOffRéessayer après correctionConteneur et sortie
L'image ne peut pas être récupérée : étiquette inexistante, registre privé sans imagePullSecrets ou registre qui limite les requêtes du nœud.
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret <secret> -o yaml- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- CreateContainerConfigErrorKubernetes CreateContainerConfigErrorRéessayer après correctionConteneur et sortie
Le conteneur ne peut pas être créé car une ressource référencée manque : un Secret ou ConfigMap, une de ses clés ou le volume qui le porte.
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret,configmap- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- EvictedKubernetes EvictedRéessayer après correctionConteneur et sortie
Le pod a été expulsé faute de mémoire, de disque ou de processus sur le nœud. Des requests et limits éloignés de l'usage réel et un nœud plein sont les causes courantes.
kubectl get pod <pod> -o jsonpath='{.status.reason}{"\\n"}{.status.message}{"\\n"}'kubectl describe node <node> | grep -i -A6 'Conditions'- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- ECONNREFUSEDECONNREFUSEDNouvelle tentative possibleErrno réseau
Rien n'écoute sur cet hôte et ce port, ou seulement sur 127.0.0.1. Dans Docker, l'hôte est le nom du service et non localhost, et le port est celui du conteneur.
nc -vz localhost 3000ss -ltnp | grep 3000docker compose ps- La même requête peut être renvoyée telle quelle.
- ECONNRESETECONNRESETNouvelle tentative possibleErrno réseau
L'autre côté a fermé la connexion en cours de requête : le pair a planté ou expiré, un proxy ou répartiteur a coupé une connexion inactive, ou du HTTP est parti vers un port TLS.
curl -v https://example.com/api/itemscurl -v --http1.1 --keepalive-time 30 https://example.com/- La même requête peut être renvoyée telle quelle.
- ETIMEDOUTETIMEDOUTNouvelle tentative possibleErrno réseau
Aucune réponse n'est arrivée à temps : routage, pare-feu ou groupe de sécurité, hôte erroné ou pair trop lent. Testez le port avant de toucher au code.
nc -vz -w 5 <host> 443curl -sS -o /dev/null -w '%{time_connect}s %{time_total}s\n' https://example.com/- La même requête peut être renvoyée telle quelle.
- ENOTFOUNDENOTFOUNDRéessayer après correctionErrno réseau
Le nom d'hôte n'a pas été résolu : faute de frappe, domaine de recherche absent, conteneur sans DNS ou résolveur qui limite les requêtes.
getent hosts api.example.comnslookup api.example.com 1.1.1.1- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- EADDRINUSEEADDRINUSERéessayer après correctionErrno réseau
Le port est déjà pris sur cette machine : un autre processus ou une instance précédente qui ne s'est jamais arrêtée.
lsof -i :3000kill -15 $(lsof -t -i :3000)- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
- EACCESEACCESRéessayer après correctionErrno réseau
Accès refusé : un port sous 1024 sans privilège, ou un fichier ou dossier dans lequel le processus ne peut pas écrire. Dans un conteneur, c'est souvent un utilisateur non root avec un volume possédé par root.
idls -ld /var/lib/appPORT=8080 node server.js- Réessayez une fois la cause corrigée ; relancer maintenant ne change rien.
Référence des statuts et codes de sortie
référence rapide- 4xx vs 5xx
- Un 4xx signale une requête cliente à corriger, un 5xx une défaillance du serveur ; un 502 ou 504 sur une seule route vient presque toujours de l'amont derrière le proxy.
- 128 + signal
- Le shell annonce un processus tué par un signal comme 128 plus le numéro du signal : 137 vaut 128+9 (SIGKILL), 143 vaut 128+15 (SIGTERM) et 139 vaut 128+11 (SIGSEGV).
- OOMKilled
- Un 137 avec OOMKilled à true dans docker inspect signifie que la limite de mémoire est atteinte ; une limite sous le pic de l'application la redémarre de la même façon.
- CrashLoopBackOff
- Kubernetes redémarre le conteneur parce qu'il se termine sans cesse ; kubectl logs --previous montre la tentative échouée.
- ECONNREFUSED
- Rien n'écoute sur cet hôte et ce port ; dans Docker l'hôte est le nom du service et non localhost, et le port est celui du conteneur.
- Retry-After
- C'est l'en-tête qu'un 429 ou un 503 envoie pour dire quand revenir ; attendez avec un peu d'aléa au lieu de réessayer en boucle serrée.
Questions fréquentes
réponses sous l'outilMon conteneur s'est arrêté avec 137, que signifie-t-il ?
137 vaut 128 + 9, soit SIGKILL : le tueur de mémoire ou un docker stop. OOMKilled dans docker inspect distingue les deux.
Que veut dire CrashLoopBackOff ?
Kubernetes redémarre sans cesse le conteneur parce qu'il se termine ; kubectl logs --previous montre pourquoi la dernière tentative est morte.
Peut-on réessayer un 503 ?
Oui, avec un backoff : c'est souvent un problème temporaire d'amont ou de capacité, et Retry-After indique combien de temps attendre.
Guides de syntaxe Linux
Tous les guides 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.