Por qué el navegador bloquea las llamadas de tu página de JavaScript a tu API, y cómo darle permiso a un origen concreto en Spring Boot, comprobando cada cabecera con curl.
También te puede interesar
Qué es CORS y por qué te bloquea
Tu API está en api.ejemplo.com y la página de la tienda, hecha con JavaScript, en tienda.ejemplo.com. Cuando la página hace fetch("https://api.ejemplo.com/api/productos"), el navegador no deja que el JavaScript lea la respuesta, y en la consola aparece un error de CORS. No es tu API la que se niega: es el navegador, que por seguridad solo deja leer respuestas del mismo origen (mismo dominio, protocolo y puerto) salvo que el servidor diga explícitamente «este otro origen puede».
CORS (Cross-Origin Resource Sharing) es ese permiso: unas cabeceras que el servidor agrega a su respuesta. Para peticiones que cambian datos o llevan cabeceras especiales, el navegador antes manda una petición previa (preflight) con el método OPTIONS para preguntar si puede.
La configuración
package com.ejemplo.api;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
public class CorsConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registro) {
registro.addMapping("/api/**")
.allowedOrigins("https://tienda.ejemplo.com")
.allowedMethods("GET", "POST")
.maxAge(3600);
}
}Para las rutas que empiezan con /api/, se acepta un solo origen, solo GET y POST, y el navegador puede recordar la respuesta de la petición previa una hora (maxAge), en vez de preguntar antes de cada llamada.
Probarlo
Con curl podemos fingir ser el navegador, mandando la cabecera Origin. Filtramos la respuesta para ver solo las cabeceras que importan:
terminal$ curl -s -i localhost:8080/api/productos -H "Origin: https://tienda.ejemplo.com" | grep -iE "^HTTP|^Access-Control|^Vary|^\[" HTTP/1.1 200 Vary: Origin Vary: Access-Control-Request-Method Vary: Access-Control-Request-Headers Access-Control-Allow-Origin: https://tienda.ejemplo.com ["Teclado", "Mouse"] $ curl -s -i localhost:8080/api/productos -H "Origin: https://sitio-raro.ejemplo.net" | grep -iE "^HTTP|^Access-Control|Invalid" HTTP/1.1 403 Invalid CORS request $ curl -s -i -X OPTIONS localhost:8080/api/productos -H "Origin: https://tienda.ejemplo.com" -H "Access-Control-Request-Method: POST" | grep -iE "^HTTP|^Access-Control" HTTP/1.1 200 Access-Control-Allow-Origin: https://tienda.ejemplo.com Access-Control-Allow-Methods: GET,POST Access-Control-Max-Age: 3600 $ curl -s -i -X OPTIONS localhost:8080/api/productos -H "Origin: https://tienda.ejemplo.com" -H "Access-Control-Request-Method: DELETE" | grep -iE "^HTTP|^Access-Control|Invalid" HTTP/1.1 403 Invalid CORS request $ curl -s localhost:8080/api/productos; echo ["Teclado", "Mouse"]
- Desde el origen permitido, la respuesta trae
Access-Control-Allow-Origin, y el navegador deja leerla. - Desde otro origen, Spring responde 403 con «Invalid CORS request».
- La petición previa de un POST responde 200 con los métodos permitidos y el
Max-Age; la de un DELETE, que no está en la lista, 403. - La última, sin
Origin, funciona: curl, Postman o tu servidor no son navegadores y CORS no les aplica.
CORS no es seguridad para tu API. Solo protege a los usuarios de un navegador de que una página ajena lea tus respuestas con sus cookies. Cualquier programa que no sea un navegador ignora estas cabeceras, como acabas de ver con curl. Para decidir quién puede usar la API hace falta autenticación, como en el ejemplo de Spring Security. Y nunca pongas allowedOrigins("*") junto con allowCredentials(true): Spring lo rechaza al arrancar, justamente porque abriría tu API a cualquier sitio con las cookies de tus usuarios. Si usas Spring Security, agrega también http.cors(Customizer.withDefaults()) para que la petición previa no se tope antes con la autenticación.
Cada proyecto de esta página se compiló con Spring Boot 4.2.0, Java 25 (Temurin 25.0.5.1) y Maven 3.10.1 en un contenedor limpio y sin red, se arrancó y se probó con las peticiones de curl que ves; las respuestas y los registros están copiados de esa ejecución.