Alibaba Cloud CDN renvoie des codes d'état HTTP standard en cas d'erreur. Cette rubrique décrit tous les codes 4xx et 5xx que le service CDN peut retourner, explique leur signification dans le contexte du CDN et liste les étapes concrètes pour les résoudre.
Codes d'état 4xx
Les codes 4xx indiquent des erreurs côté client. La requête a atteint le réseau CDN mais n'a pas pu aboutir, soit en raison d'un problème lié à la requête elle-même, soit parce que le client ne disposait pas des autorisations ou des informations d'identification requises.
400 Bad Request
Le serveur d'origine n'a pas pu comprendre ou traiter la requête en raison d'une syntaxe incorrecte ou de paramètres non valides.
Résolution : Vérifiez l'absence d'erreurs dans les paramètres de la requête et renvoyez-la.
401 Unauthorized
La requête ne contenait pas d'informations d'authentification valides. Le serveur d'origine exige une authentification avant de traiter la requête.
Résolution : Incluez des informations d'authentification valides et réessayez. Si l'authentification est gérée par le serveur d'origine, autorisez d'abord la requête au niveau de ce dernier.
403 Forbidden
Le serveur d'origine a compris la requête, mais a refusé d'y répondre car le client ne dispose pas de l'autorisation nécessaire pour accéder à la ressource.
Résolution : Accordez les autorisations requises au client, puis réessayez.
404 Not Found
Le serveur d'origine n'a pas trouvé la ressource demandée.
Résolution :
Vérifiez que le chemin de la requête est correct.
Confirmez que la ressource existe sur le serveur d'origine.
Vérifiez si le chemin URL du serveur d'origine est accessible depuis Internet.
405 Method Not Allowed
Le serveur d'origine reconnaît la ressource, mais ne prend pas en charge la méthode HTTP utilisée (par exemple, l'envoi d'une requête POST vers un endpoint qui n'accepte que les requêtes GET).
Résolution : Modifiez la requête pour utiliser une méthode HTTP prise en charge par le serveur d'origine, puis réessayez.
406 Not Acceptable
Le serveur d'origine ne peut pas renvoyer la ressource dans un format satisfaisant les en-têtes de négociation de contenu du client (par exemple, Accept-Charset ou Accept-Language).
Résolution : Mettez à jour les en-têtes de la requête pour spécifier des types de contenu et des encodages pris en charge par le serveur d'origine, puis réessayez.
407 Proxy Authentication Required
Le client n'a pas fourni les informations d'authentification requises par le serveur proxy situé entre le client et l'origine.
Résolution :
Vérifiez si l'authentification auprès du serveur proxy d'origine a expiré.
Incluez les informations d'identification correctes émises par le serveur proxy d'origine.
Réessayez la requête.
408 Request Timeout
Le serveur d'origine n'a pas reçu la requête complète dans le délai imparti et a fermé la connexion.
Résolution : Augmentez le délai d'attente du serveur d'origine ou réduisez la taille de la charge utile de la requête, puis réessayez.
409 Conflict
La requête entre en conflit avec l'état actuel de la ressource cible. Cela se produit souvent avec les requêtes PUT lorsqu'un client tente de mettre à jour une ressource qui a changé depuis sa dernière récupération.
Résolution : Actualisez la ressource, intégrez les modifications éventuelles et soumettez à nouveau la requête. Vous pouvez également ajouter une logique de gestion des conflits sur le serveur d'origine.
410 Gone
La ressource a été intentionnellement et définitivement supprimée du serveur d'origine.
Résolution : Supprimez toutes les références à la ressource supprimée dans votre client ou votre application. Contrairement au code 404, le code 410 signale une suppression permanente : ne réessayez pas indéfiniment.
411 Length Required
La requête est dépourvue de l'en-tête Content-Length , requis par le serveur d'origine pour traiter le corps de la requête.
Résolution :
Si la longueur du contenu est connue, ajoutez
Content-Length: <size>à l'en-tête de la requête.Si la longueur ne peut pas être déterminée à l'avance, utilisez plutôt
Transfer-Encoding: chunked.
412 Precondition Failed
Le serveur d'origine a évalué les en-têtes conditionnels de la requête (par exemple, If-Match ou If-Unmodified-Since) et la condition préalable n'a pas été remplie.
Résolution : Mettez à jour la requête pour inclure des conditions préalables valides et actuelles, puis réessayez.
413 Payload Too Large
La charge utile de la requête dépasse la taille maximale acceptée par la configuration du serveur d'origine.
Résolution : Réduisez la taille du téléchargement ou de la soumission, puis réessayez.
414 URI Too Long
L'URI de la requête est plus long que ce que le serveur d'origine est prêt à traiter.
Résolution : Raccourcissez l'URI. Si la requête contient un grand nombre de paramètres, répartissez-les sur plusieurs requêtes et agrégez les résultats côté client.
415 Unsupported Media Type
Le format de la charge utile de la requête n'est pas pris en charge par le serveur d'origine.
Résolution : Définissez l'en-tête Content-Type de la requête sur un type de média accepté par le serveur d'origine, puis réessayez.
416 Range Not Satisfiable
L'en-tête Range de la requête spécifie une plage d'octets qui se situe en dehors des limites de la ressource.
Résolution : Vérifiez que la plage indiquée dans l'en-tête Range est valide pour la taille de la ressource, corrigez-la si nécessaire et réessayez.
417 Expectation Failed
Le serveur d'origine n'a pas pu satisfaire l'attente spécifiée dans l'en-tête de requête Expect .
Résolution : Ce code apparaît le plus souvent lors des tests. S'il apparaît en production, désactivez le champ Expect dans l'en-tête de la requête.
429 Too Many Requests
Le client a dépassé le seuil de limitation de débit du serveur d'origine au cours d'une période donnée.
Résolution : Attendez et réessayez après l'intervalle indiqué par l'en-tête de réponse Retry-After (s'il est présent), ou après la réinitialisation de la fenêtre de limitation de débit définie par le serveur d'origine.
499 Client Closed Request
Le client a fermé la connexion avant que le serveur n'ait terminé le traitement de la requête et l'envoi d'une réponse.
Cela se produit généralement lorsque les clients expirent localement lors d'opérations lentes, par exemple lors de téléchargements de fichiers volumineux ou d'appels API de longue durée. Comme le client s'est déjà déconnecté, il ne reçoit aucune page d'erreur.
Codes d'état 5xx
500 Internal Server Error
Votre serveur d'origine a rencontré une erreur interne et n'a pas pu traiter la requête.
Résolution :
Consultez les journaux d'erreurs du serveur d'origine pour identifier la cause racine.
Si un déploiement récent a provoqué l'erreur, revenez à la dernière version fonctionnelle pour rétablir le service.
Corrigez le problème sous-jacent et confirmez que l'origine répond correctement avant de réessayer.
502 Bad Gateway
Un POP CDN n'a pas pu se connecter à votre serveur d'origine et n'a reçu aucune réponse valide.
Résolution :
Confirmez que votre serveur d'origine est en cours d'exécution et accessible.
Vérifiez les règles de pare-feu du serveur d'origine pour vous assurer que le trafic entrant provenant des POP CDN est autorisé.
Examinez les journaux du serveur d'origine pour détecter d'éventuelles erreurs de connexion.
503 Service Unavailable
Votre serveur d'origine est temporairement surchargé et ne peut pas traiter la requête.
Résolution :
Vérifiez la charge de votre serveur d'origine pour identifier l'application ou le processus qui consomme des ressources excessives.
504 Gateway Timeout
Un POP CDN a envoyé une requête à votre serveur d'origine, mais n'a reçu aucune réponse dans le délai d'attente configuré.
Résolution :
Confirmez que votre serveur d'origine est disponible et accessible.
Vérifiez les performances du serveur d'origine : des requêtes de base de données lentes ou des processus de longue durée peuvent provoquer des délais d'expiration.
Si l'origine a légitimement besoin de plus de temps pour répondre, augmentez le délai d'attente selon les besoins.
508 Loop Detected
Une requête transférée par un POP CDN a été redirigée vers le réseau CDN, créant une boucle infinie qui a dépassé la limite maximale de redirections.
Cela se produit généralement lorsque le serveur d'origine ou une règle de redirection renvoie le trafic vers le domaine CDN qui a initié la requête.
Résolution :
Vérifiez l'absence de références circulaires dans votre serveur d'origine et dans les règles de redirection.
Assurez-vous que chaque boucle ou chaîne de redirection possède une condition de terminaison.
Après avoir corrigé la boucle, réessayez la requête.