<!-- Erreurs serveur 5xx : liste des codes, sens et 509 — Uptimely -->
> Markdown version of https://getuptimely.com/fr/errors/5xx — the page itself is the canonical copy.

Guide des erreurs

# Erreurs serveur 5xx

La classe qui signifie que le serveur n'a pas pu traiter une requête qui, à sa connaissance, était valide.

Un statut 5xx signifie que le serveur n'a pas pu traiter une requête qui semblait valide. La responsabilité se trouve côté serveur : l'application, ses dépendances ou l'infrastructure placée devant elle. Contrairement à un 4xx, aucun changement côté client ne l'aurait évité.

C'est la classe pour laquelle la surveillance existe, et chacun de ses codes devrait faire échouer une vérification par défaut. C'est aussi la classe la plus visible pour les clients, car un 5xx signifie généralement qu'une requête qui aurait dû fonctionner n'a pas fonctionné.

Le code précis indique quelle couche a échoué, ce qui constitue l'essentiel du premier tri : 500, c'est l'application qui lève une exception ; 502 et 504, c'est un proxy qui signale que quelque chose derrière lui a échoué ou a été trop lent ; 503 est un refus délibéré pour cause de capacité ou de maintenance ; 501 est une méthode que le serveur n'implémente pas. Atteindre vite la bonne couche vaut plus que n'importe quelle supposition sur les causes.

__Liste des codes d'erreur 5xx : les erreurs serveur enregistrées, plus 509 et les codes 52x de Cloudflare__
| Code | Nom                                 | Défini dans                                                                                          |
| ---- | ----------------------------------- | ---------------------------------------------------------------------------------------------------- |
| 500  | Internal Server Error               | RFC 9110                                                                                             |
| 501  | Not Implemented                     | RFC 9110                                                                                             |
| 502  | Bad Gateway                         | RFC 9110                                                                                             |
| 503  | Service Unavailable                 | RFC 9110                                                                                             |
| 504  | Gateway Timeout                     | RFC 9110                                                                                             |
| 505  | HTTP Version Not Supported          | RFC 9110                                                                                             |
| 506  | Variant Also Negotiates             | RFC 2295                                                                                             |
| 507  | Insufficient Storage                | RFC 4918 (WebDAV)                                                                                    |
| 508  | Loop Detected                       | RFC 5842 (WebDAV)                                                                                    |
| 509  | Bandwidth Limit Exceeded            | Non enregistré : envoyé par certains hébergeurs quand un compte a épuisé son quota de bande passante |
| 510  | Not Extended                        | RFC 2774, désormais obsolète                                                                         |
| 511  | Network Authentication Required     | RFC 6585                                                                                             |
| 520  | Web Server Returns an Unknown Error | Cloudflare, non enregistré                                                                           |
| 521  | Web Server Is Down                  | Cloudflare, non enregistré                                                                           |
| 522  | Connection Timed Out                | Cloudflare, non enregistré                                                                           |
| 523  | Origin Is Unreachable               | Cloudflare, non enregistré                                                                           |
| 524  | A Timeout Occurred                  | Cloudflare, non enregistré                                                                           |
| 525  | SSL Handshake Failed                | Cloudflare, non enregistré                                                                           |
| 526  | Invalid SSL Certificate             | Cloudflare, non enregistré                                                                           |

## Causes fréquentes

- Une exception non gérée dans le code de l'application.
- Une dépendance (base de données, cache, file d'attente, API tierce) qui échoue ou dépasse son délai.
- L'épuisement des ressources : mémoire, descripteurs de fichiers, pools de connexions, disque.
- Un déploiement qui a introduit un bug, ou un changement de configuration qui a cassé une connexion.
- Un service upstream en panne, injoignable ou qui répond trop lentement.

## Comment le diagnostiquer

1. Lisez d'abord le code exact : il identifie la couche, et la couche indique où chercher.
2. Vérifiez si l'erreur figure dans le journal de votre application ou seulement dans celui du proxy : cela suffit à couper la recherche en deux.
3. Établissez si toutes les requêtes sont touchées ou seulement une partie, ce qui distingue une panne totale d'une panne partielle.
4. Rapprochez l'heure de début des déploiements, des changements de configuration et des incidents de dépendances.
5. Vérifiez la santé de chaque dépendance avant de déboguer votre propre code ; la plupart des incidents 5xx sont la panne de quelqu'un d'autre qui arrive chez vous.

## À qui la faute ? Côté serveur

Par définition côté serveur, même si un 5xx est souvent causé par une dépendance plutôt que par l'application elle-même, et cela reste votre incident même quand ce n'est pas votre bug.

## Ce que voit la surveillance

Les critères par défaut d'Uptimely font échouer une vérification sur un 5xx et enregistrent le code exact. Un moniteur déclare un incident une fois le seuil d'échec atteint (deux vérifications échouées d'affilée par défaut) : un incident isolé est donc enregistré comme indisponibilité sans alerter personne, tandis qu'un 5xx persistant ouvre un incident et déclenche la politique d'astreinte.

## Guides d'erreurs associés

- [500 Internal Server Error](https://getuptimely.com/errors/500)
- [502 Bad Gateway](https://getuptimely.com/errors/502)
- [503 Service Unavailable](https://getuptimely.com/errors/503)
- [504 Gateway Timeout](https://getuptimely.com/errors/504)
- [501 Not Implemented](https://getuptimely.com/errors/501)
- [508 Loop Detected](https://getuptimely.com/errors/508)
- [Erreurs client 4xx](https://getuptimely.com/fr/errors/4xx)

## Termes employés sur cette page

- [Incident](https://getuptimely.com/glossary/incident)
- [Seuil d'échec](https://getuptimely.com/glossary/failure-threshold)
- [Codes de statut HTTP](https://getuptimely.com/glossary/http-status-codes)
- [Alerte](https://getuptimely.com/glossary/alert)

## Questions

### Chaque 5xx doit-il déclencher une alerte ?

Chaque 5xx doit faire échouer la vérification. Qu'il déclenche une alerte dépend du seuil : attendre deux échecs d'affilée élimine les incidents isolés tout en les enregistrant comme indisponibilité, ce qui est presque toujours le bon réglage par défaut.

### Quels codes 5xx désignent un proxy plutôt que mon application ?

502 et 504 sont produits par quelque chose placé devant votre application : un reverse proxy ou un CDN qui signale que l'upstream a échoué ou a été trop lent. Un 500 vient de l'application elle-même.

L'un des [guides Uptimely des erreurs HTTP et réseau](https://getuptimely.com/errors), écrits pour la personne qui exploite le serveur plutôt que pour celle qui recharge la page. Something here read wrong to you? Email **support@getuptimely.com**.

Vérifié le 2026-11-15 par l'équipe Uptimely.
