Lorsqu'un envoi SMTP échoue, un code d'erreur est retourné par le serveur pour indiquer la nature du problème. Cet article vous explique ce que signifient les codes d'erreur les plus fréquents et comment réagir selon le cas.
À quoi ça sert
Comprendre les codes d'erreur vous permet de :
- Identifier rapidement la cause d'un problème d'envoi
- Prendre la bonne action selon le type d'erreur
- Distinguer une erreur temporaire d'une erreur permanente
Comment ça fonctionne
Les codes d'erreur SMTP suivent une structure standard. Le premier chiffre indique le type de réponse :
- 4xx : erreur temporaire — une nouvelle tentative peut réussir
- 5xx : erreur permanente — le message ne sera pas livré sans correction
Les codes d'erreur par catégorie
Erreurs d'authentification
| Code | Message | Ce que ça signifie |
|---|---|---|
| 535 5.7.8 | Authentication credentials invalid | Le nom d'utilisateur ou le mot de passe est invalide |
| 538 5.7.0 | Must issue a STARTTLS command first | Votre application tente de s'authentifier sans connexion sécurisée |
| 530 5.7.0 | Authentication required | Une commande d'envoi a été lancée avant l'authentification |
| 535 5.7.8 | Authentication blocked due to too many failed attempts | Trop de tentatives échouées — votre adresse IP est bloquée temporairement. Patientez quelques minutes avant de réessayer, et assurez-vous d'avoir les bons identifiants. |
Erreurs liées aux limites du service
| Code | Message | Ce que ça signifie |
|---|---|---|
| 452 4.2.2 | Quota exceeded for the current period | Le quota mensuel de votre forfait est atteint |
| 452 4.5.3 | Too many recipients (max 50 per message) | Le message dépasse la limite de 50 destinataires |
| 454 4.7.0 | Too many active sessions for user | Votre utilisateur SMTP a atteint sa limite de connexions simultanées. Fermez les connexions inutiles et réessayez. |
| 454 4.7.0 | Too many active sessions for account | Votre compte a atteint sa limite de connexions simultanées. Fermez les connexions inutiles et réessayez. |
Erreurs liées aux adresses
| Code | Message | Ce que ça signifie |
|---|---|---|
| 501 5.5.4 | Bad sender address syntax | L'adresse d'expéditeur n'est pas valide |
| 501 5.5.4 | Recipient rejected: bad recipient address syntax | L'adresse du destinataire n'est pas valide |
Erreurs liées au contenu du message
| Code | Message | Ce que ça signifie |
|---|---|---|
| 523 5.3.4 | Message size exceeds fixed maximum message size | La taille du message dépasse 20 Mo |
| 550 5.6.0 | Failed to parse MIME structure | La structure du message est invalide ou une pièce jointe est corrompue. Cela survient souvent lorsque le contenu d'un fichier ne correspond pas à son extension (ex. : un fichier renommé en .pdf qui n'est pas réellement un PDF). Vérifiez vos pièces jointes. |
| 554 5.6.0 | Multiple header From: addresses is not supported | Le champ From contient plus d'une adresse |
| 554 5.6.0 | Header From: address domain does not match authenticated user domain | Le domaine de l'expéditeur ne correspond pas au domaine de l'utilisateur SMTP authentifié |
Erreurs liées au domaine
| Code | Message | Ce que ça signifie |
|---|---|---|
| 550 5.6.0 | The domain is not correctly authenticated | Le domaine utilisé n'est pas correctement configuré ou validé |
Erreurs temporaires du système
| Code | Message | Ce que ça signifie |
|---|---|---|
| 421 4.4.2 | Temporary local problem: unable to relay message | Problème temporaire du système — réessayez plus tard |
| 421 4.4.2 | Temporary local problem: unable to connect to upstream relay | Problème temporaire de connexion au relais — réessayez plus tard |
Que faire lorsqu'un code d'erreur s'affiche
Selon le code reçu, voici les vérifications à effectuer :
- Erreur d'authentification : vérifiez votre nom d'utilisateur et votre mot de passe SMTP, et assurez-vous que le chiffrement TLS est activé
Plus précisément :- Identifiants invalides (535) : vérifiez votre nom d'utilisateur et votre mot de passe SMTP dans l'onglet Domaines de votre compte
- Connexion non sécurisée (538) : votre application tente de s'authentifier sans avoir activé STARTTLS. Activez le chiffrement TLS dans les paramètres de votre application : cherchez l'option « STARTTLS », « TLS » ou « Connexion sécurisée »
- IP bloquée (535 - trop de tentatives) : patientez quelques minutes et assurez-vous d'avoir les bons identifiants avant de réessayer
- Quota atteint : attendez le renouvellement de votre période ou changez de forfait dans l'onglet Tarification
- Trop de destinataires : réduisez le nombre de destinataires à 50 maximum par message
- Trop de connexions simultanées (454) : fermez les connexions SMTP inutiles dans votre application et attendez quelques secondes avant de réessayer.
- Message trop volumineux : réduisez la taille des pièces jointes ou utilisez des liens de téléchargement
- Domaine non authentifié : vérifiez que vos enregistrements DKIM 1, DKIM 2 et SPF/Return-Path (MX) sont bien validés dans l'onglet Domaines
- Domaine non correspondant (554) : l'adresse d'expéditeur configurée dans votre application ne correspond pas au domaine lié à votre utilisateur SMTP. Vérifiez que le domaine de votre adresse From (ex. : votre-entreprise.com) est bien le même que celui associé à votre utilisateur SMTP dans l'onglet Domaines.
- Erreur temporaire : réessayez l'envoi, ces erreurs se résolvent généralement d'elles-mêmes
Si le problème persiste, notez le code exact et communiquez avec notre équipe de soutien.
Voir aussi :