Por qué 'Request header field x-auth-token is not allowed' salta y cómo configurar Allow-Headers en el servidor.
Escenarios
Petición — lado del navegador (página)
Method
Content-Type
Cabecera personalizada
Access-Control-Request-Headers: content-type, x-auth-token
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: POST Access-Control-Request-Headers: content-type, x-auth-token
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, PUT Access-Control-Allow-Headers: content-type
Allow-Origin coincide con el origen — pasa
El método está en Allow-Methods — pasa
Una cabecera falta en Allow-Headersx-auth-token
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: Request header field content-type is not allowed by Access-Control-Allow-Headers 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.
Cabeceras como Authorization o X-Api-Key — e incluso un Content-Type JSON — viajan en el ACRH del preflight. Si Allow-Headers no las cubre todas, bloquea con 'header field X is not allowed'.
La trampa no son las mayúsculas (las cabeceras no distinguen caso) sino la omisión: olvidar que content-type también debe estar permitido. Solo con authorization sigue fallando. Simulador CORS