Alibaba Cloud CDN devuelve códigos de estado HTTP estándar cuando ocurren errores. Esta referencia describe cada código 4xx y 5xx que CDN puede devolver, explica su significado en el contexto de CDN y detalla los pasos concretos para resolverlo.
Códigos de estado 4xx
Los códigos 4xx indican errores del lado del cliente. La solicitud llegó a la red de CDN, pero no se pudo completar debido a un problema en la propia solicitud o porque el cliente carecía de los permisos o credenciales obligatorios.
400 Bad Request
El servidor de origen no pudo interpretar ni procesar la solicitud por una sintaxis incorrecta o parámetros no válidos.
Solución: Revise los parámetros de la solicitud para detectar errores y vuelva a enviarla.
401 Unauthorized
La solicitud no incluyó credenciales de autenticación válidas. El servidor de origen requiere autenticación antes de procesar la solicitud.
Solución: Incluya credenciales de autenticación válidas y reintente. Si la autenticación se gestiona en el servidor de origen, autorice primero la solicitud en ese servidor.
403 Forbidden
El servidor de origen interpretó la solicitud, pero rechazó completarla porque el cliente no tiene permiso para acceder al recurso.
Solución: Otorgue los permisos obligatorios al cliente y reintente.
404 Not Found
El servidor de origen no encontró el recurso solicitado.
Solución:
Compruebe que la ruta de la solicitud sea correcta.
Confirme que el recurso existe en el servidor de origen.
Verifique si la ruta URL del servidor de origen es accesible desde internet.
405 Method Not Allowed
El servidor de origen reconoce el recurso, pero no admite el método HTTP utilizado (por ejemplo, enviar un POST a un endpoint que solo acepta GET).
Solución: Cambie la solicitud a un método HTTP que admita el servidor de origen y reintente.
406 Not Acceptable
El servidor de origen no puede devolver el recurso en un formato que cumpla con los encabezados de negociación de contenido del cliente (por ejemplo, Accept-Charset o Accept-Language).
Solución: Actualice los encabezados de la solicitud para especificar tipos de contenido y codificaciones que admita el servidor de origen, y reintente.
407 Proxy Authentication Required
El cliente no proporcionó las credenciales de autenticación que exige el servidor proxy ubicado entre el cliente y el origen.
Solución:
Compruebe si la autenticación del servidor de origen del proxy expiró.
Incluya las credenciales correctas emitidas por el servidor de origen del proxy.
Reintente la solicitud.
408 Request Timeout
El servidor de origen no recibió la solicitud completa dentro de su ventana de tiempo de espera y cerró la conexión.
Solución: Amplíe el periodo de tiempo de espera del servidor de origen o reduzca el tamaño de la carga útil de la solicitud, y reintente.
409 Conflict
La solicitud entra en conflicto con el estado actual del recurso de destino. Esto suele ocurrir con solicitudes PUT cuando un cliente intenta actualizar un recurso que cambió desde la última vez que se recuperó.
Solución: Actualice el recurso, incorpore los cambios correspondientes y vuelva a enviarlo. Como alternativa, agregue lógica de manejo de conflictos en el servidor de origen.
410 Gone
El recurso se eliminó de forma intencional y permanente del servidor de origen.
Solución: Elimine todas las referencias al recurso borrado en su cliente o aplicación. A diferencia del 404, un 410 indica una eliminación permanente; no reintente de forma indefinida.
411 Length Required
A la solicitud le falta el encabezado Content-Length, que el servidor de origen necesita para procesar el cuerpo de la solicitud.
Solución:
Si conoce la longitud del contenido, agregue
Content-Length: <size>al encabezado de la solicitud.Si no es posible determinar la longitud de antemano, utilice
Transfer-Encoding: chunkeden su lugar.
412 Precondition Failed
El servidor de origen evaluó los encabezados condicionales de la solicitud (por ejemplo, If-Match o If-Unmodified-Since) y la condición previa no se cumplió.
Solución: Actualice la solicitud para incluir condiciones previas válidas y actuales, y reintente.
413 Payload Too Large
La carga útil de la solicitud supera el tamaño máximo que el servidor de origen está configurado para aceptar.
Solución: Reduzca el tamaño de la carga o del envío y reintente.
414 URI Too Long
El URI de la solicitud es más largo de lo que el servidor de origen está dispuesto a procesar.
Solución: Acorte el URI. Si la solicitud contiene una gran cantidad de parámetros, divídalos en varias solicitudes y agregue los resultados del lado del cliente.
415 Unsupported Media Type
La carga útil de la solicitud tiene un formato que el servidor de origen no admite.
Solución: Establezca Content-Type en el encabezado de la solicitud con un tipo de medio que admita el servidor de origen y reintente.
416 Range Not Satisfiable
El encabezado Range de la solicitud especifica un intervalo de bytes que queda fuera de los límites del recurso.
Solución: Compruebe que el intervalo del encabezado Range sea válido para el tamaño del recurso, corríjalo y reintente.
417 Expectation Failed
El servidor de origen no pudo cumplir con la expectativa indicada en el encabezado de solicitud Expect.
Solución: Este código aparece con mayor frecuencia durante las pruebas. Si se presenta en producción, deshabilite el campo Expect en el encabezado de la solicitud.
429 Too Many Requests
El cliente superó el umbral de limitación de velocidad del servidor de origen dentro de una ventana de tiempo determinada.
Solución: Espere y reintente después del intervalo indicado por el encabezado de respuesta Retry-After (si está presente), o bien cuando se restablezca la ventana de límite de velocidad configurada por el servidor de origen.
499 Client Closed Request
El cliente cerró la conexión antes de que el servidor terminara de procesar la solicitud y enviara una respuesta.
Esto suele ocurrir cuando los clientes agotan el tiempo de espera localmente durante operaciones lentas, como cargas de archivos grandes o llamadas API prolongadas. Dado que el cliente ya se desconectó, no recibe ninguna página de error.
Códigos de estado 5xx
500 Internal Server Error
El servidor de origen experimentó un error interno y no pudo procesar la solicitud.
Solución:
Revise los registros de errores del servidor de origen para identificar la causa raíz.
Si un despliegue reciente provocó el error, revierta a la última versión funcional para restaurar el servicio.
Corrija el problema subyacente y confirme que el origen responde correctamente antes de reintentar.
502 Bad Gateway
Un POP de CDN no pudo conectarse al servidor de origen y no recibió una respuesta válida.
Solución:
Confirme que el servidor de origen esté en ejecución y sea accesible.
Revise las reglas del firewall del servidor de origen para asegurarse de que se permita el tráfico entrante desde los POP de CDN.
Consulte los registros del servidor de origen en busca de errores de conexión.
503 Service Unavailable
El servidor de origen está sobrecargado temporalmente y no puede atender la solicitud.
Solución:
Revise la carga del servidor de origen para identificar qué aplicación o proceso consume recursos excesivos.
504 Gateway Timeout
Un POP de CDN envió una solicitud al servidor de origen, pero no recibió respuesta dentro del periodo de tiempo de espera configurado.
Solución:
Confirme que el servidor de origen esté disponible y sea accesible.
Revise el rendimiento del servidor de origen, ya que consultas lentas a la base de datos o procesos prolongados pueden provocar tiempos de espera agotados.
Si el origen realmente necesita más tiempo para responder, aumente el periodo de tiempo de espera según sea necesario.
508 Loop Detected
Una solicitud reenviada por un POP de CDN se redirigió de vuelta a la red de CDN. Esto creó un bucle infinito que superó el límite máximo de redirecciones.
Suele ocurrir cuando el servidor de origen o una regla de redirección envía el tráfico de regreso al dominio de CDN que inició la solicitud.
Solución:
Revise el servidor de origen y las reglas de redirección en busca de referencias circulares.
Asegúrese de que cada bucle o cadena de redirecciones tenga una condición de finalización.
Una vez corregido el bucle, reintente la solicitud.