CORS método rechazado — Allow-Methods

Por qué 'Method PUT is not allowed by Access-Control-Allow-Methods' aparece en el preflight y cómo arreglar la lista del servidor.

Escenarios

Petición — lado del navegador (página)

Method

Content-Type

Cabecera personalizada

Access-Control-Request-Headers: content-type

Respuesta — cabeceras que envía el servidor

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

Cabeceras que la petición necesita + comunes — clic para alternar

Pasos del navegador

→

La página lanza un fetch

•

No es petición simple — se requiere preflight OPTIONS

→

Preflight OPTIONS enviado

OPTIONS /data HTTP/1.1
Origin: https://myapp.example.com
Access-Control-Request-Method: PUT
Access-Control-Request-Headers: content-type
←

Llega la respuesta preflight del servidor

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://myapp.example.com
Access-Control-Allow-Methods: GET, POST
Access-Control-Allow-Headers: content-type
✓

Allow-Origin coincide con el origen — pasa

✗

El método no está en Allow-MethodsPUT

✓

Todas las cabeceras están en Allow-Headers — pasa

—

Sin credenciales — comprobación omitida

✗

El navegador bloquea la respuesta y rechaza el fetch

Consola del navegador

✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: Method content-type is not allowed by Access-Control-Allow-Methods in preflight response.

(index):1

Cambia cualquier valor y los pasos se recalculan al instante. Prueba «credentials + *» para ver por qué el comodín falla.

Con PUT/DELETE/PATCH la petición requiere preflight, y si Allow-Methods no incluye ese método, el navegador bloquea sin enviar la real — aunque el endpoint exista.

Errores típicos: listar solo GET/POST en Allow-Methods, o que el servidor/proxy rechace OPTIONS con 404/405 y el preflight muera al empezar.

Marca y desmarca PUT en el simulador: verás el fallo pararse en preflight y que la línea de petición real ni aparece — «el servidor está bien pero no hay logs». Simulador CORS

Preguntas frecuentes

¿Puedo usar * en Allow-Methods?
Sin credenciales la mayoría lo acepta; con credenciales se ignora el comodín — lista los métodos explícitamente.
¿Y si el servidor rechaza OPTIONS con 405?
El preflight falla y la petición real nunca llega. Abre OPTIONS y devuelve 204 con las cabeceras CORS.

Otros escenarios