Pages

Sujets

Outils

↑↓naviguer↵ouvrirescfermer
Encodage et sécurité

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é.

Recherche rapide
42 codesChaque entrée donne la cause, la commande à lancer ensuite et si une nouvelle tentative aide.
  • 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/health
    • curl -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/items
    • echo '{"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/me
    • curl -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/42
    • curl -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.zip
    • curl -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-after
    • sleep 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/items
    • docker 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-after
    • docker 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/slow
    • psql "$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 100
    • kubectl 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 3000
    • ss -ltnp | grep 3000
    • docker 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/items
    • curl -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> 443
    • curl -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.com
    • nslookup 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 :3000
    • kill -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.

    • id
    • ls -ld /var/lib/app
    • PORT=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'outil
Mon 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.

Tous les guides Linux