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