Erreur HTTP 400 : Bad Request

L'erreur HTTP 400 "Bad Request" est l'une des erreurs client les plus courantes sur le web. Elle indique que le serveur n'a pas pu comprendre ou traiter la requête en raison d'une syntaxe incorrecte, de données mal formées ou de paramètres invalides.

Contrairement aux erreurs 5xx qui signalent un problème serveur, le code 400 pointe vers un problème côté client. Cela peut être une URL mal encodée, un corps de requête JSON invalide, des en-têtes HTTP incorrects ou des cookies corrompus. Identifier la cause exacte requiert une analyse méthodique.

Pour les APIs REST et les applications web modernes, le monitoring des erreurs 400 est essentiel. Un pic soudain de 400 peut indiquer un bug dans votre frontend, une incompatibilité après une mise à jour, ou une attaque tentant de faire planter votre système.

Causes principales des erreurs 400

Les erreurs 400 peuvent provenir de nombreuses sources. Voici les causes les plus fréquentes :

• URL mal formée : Caractères spéciaux non encodés, espaces dans l'URL, ou paramètres de requête invalides. Exemple : /page?name=Jean Pierre au lieu de /page?name=Jean%20Pierre.
• Corps de requête invalide : JSON mal formé, XML invalide, ou données form-data avec une structure incorrecte. Les accolades manquantes ou les virgules en trop sont des erreurs courantes.
• Cookies corrompus : Des cookies trop volumineux ou contenant des caractères invalides peuvent provoquer un 400. Cela arrive souvent après des mises à jour qui changent le format des cookies.
• En-têtes HTTP invalides : Content-Type manquant ou incorrect, Authorization mal formaté, ou en-têtes personnalisés avec des valeurs interdites.

Diagnostic d'une erreur 400

Pour identifier la cause exacte d'une erreur 400, suivez cette méthodologie :

• Inspecter la requête : Utilisez les DevTools du navigateur (onglet Network) pour examiner la requête complète : URL, en-têtes, corps et cookies envoyés.
• Tester en isolation : Reproduisez la requête avec curl ou Postman pour éliminer les variables liées au navigateur ou au cache.
• Consulter les logs serveur : Les logs serveur contiennent souvent un message détaillé expliquant pourquoi la requête a été rejetée.
• Tester en navigation privée : Si l'erreur disparaît en navigation privée, le problème vient probablement des cookies ou du cache local.

Résolution des erreurs 400

Selon la cause identifiée, voici les solutions à appliquer :

• Encoder correctement l'URL : Utilisez encodeURIComponent() en JavaScript ou urlencode() en PHP pour les paramètres contenant des caractères spéciaux.
• Valider le JSON : Avant d'envoyer une requête, validez le JSON avec JSON.parse() ou un outil en ligne. Vérifiez les guillemets doubles et l'absence de virgules finales.
• Vider les cookies : Supprimez les cookies du domaine concerné. Si le problème est généralisé, envisagez de changer le format de vos cookies.
• Corriger les en-têtes : Assurez-vous que Content-Type correspond au corps envoyé (application/json pour du JSON, multipart/form-data pour les fichiers).

Exemples de validation et diagnostic

Voici des exemples de code pour diagnostiquer et prévenir les erreurs 400 :

// JavaScript - Valider JSON avant envoi
function safeSendJSON(url, data) {
    try {
        const jsonString = JSON.stringify(data);
        JSON.parse(jsonString); // Vérification de validité
        return fetch(url, {
            method: "POST",
            headers: { "Content-Type": "application/json" },
            body: jsonString
        });
    } catch (e) {
        console.error("JSON invalide:", e.message);
        throw new Error("Données invalides");
    }
}

// PHP - Validation côté serveur
$json = file_get_contents("php://input");
$data = json_decode($json, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    http_response_code(400);
    echo json_encode(["error" => "JSON invalide"]);
    exit;
}

Une validation côté client ET serveur est essentielle. Côté client pour une meilleure UX, côté serveur pour la sécurité.

Prévention des erreurs 400

Mieux vaut prévenir que guérir. Voici les bonnes pratiques :

• Validation frontend : Validez les données de formulaire avant envoi avec des bibliothèques comme Yup, Joi ou Zod.
• Tests automatisés : Incluez des tests d'intégration qui vérifient le comportement de votre API face à des entrées invalides.
• Limites de taille : Documentez et validez les limites de taille des requêtes (body, URL, cookies) pour éviter les dépassements.
• Messages d'erreur clairs : Retournez des messages d'erreur descriptifs pour aider au débogage. Évitez les 400 génériques sans explication.

Questions fréquentes sur HTTP 400

Conclusion

L'erreur HTTP 400 Bad Request signale que quelque chose ne va pas dans la requête envoyée au serveur. Une bonne pratique consiste à valider les données côté client avant envoi, et à fournir des messages d'erreur explicites côté serveur pour faciliter le diagnostic.

Avec MoniTao, surveillez vos endpoints critiques et soyez alerté dès qu'une erreur 400 apparaît. Un monitoring proactif permet de détecter les problèmes d'intégration, les incompatibilités après mise à jour, et les tentatives d'exploitation avant qu'ils n'impactent vos utilisateurs.

Prêt à dormir sur vos deux oreilles ?

Commencez gratuitement, sans carte bancaire.

Créer mon compte Voir les tarifs