When allowCredentials is true, allowedOrigins cannot contain the special value "*" since that cannot be set on the "Access-Control-Allow-Origin" response header.
Ai configurat CORS cu allowCredentials(true) și allowedOrigins("*"), combinație interzisă de specificația CORS: cu cookie-uri sau autentificare, serverul trebuie să numească originea exactă. Listează originile concrete sau folosește allowedOriginPatterns.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Specificația CORS interzice răspunsul Access-Control-Allow-Origin: * împreună cu Access-Control-Allow-Credentials: true: browserul nu trimite și nu acceptă cookie-uri sau antete de autentificare către „orice origine”. Spring verifică regula când procesează configurarea și aruncă IllegalArgumentException: When allowCredentials is true, allowedOrigins cannot contain the special value "*" since that cannot be set on the "Access-Control-Allow-Origin" response header. To allow credentials to a set of origins, list them explicitly or consider using "allowedOriginPatterns" instead.
Eroarea apare la prima cerere cu antetul Origin (sau la pornire, după configurare), de obicei ca 500 la cererile din browser.
Combinația e tentantă („să meargă de oriunde, cu login”), dar ar fi și periculoasă: orice site ar putea face cereri autentificate în numele utilizatorului. Soluția e lista explicită de origini de încredere sau, pentru subdomenii, allowedOriginPatterns("https://*.magazin.ro"), caz în care Spring întoarce originea exactă a cererii.
De ce apare: cauzele frecvente
1Wildcard cu credențiale
r.addMapping("/api/**")
.allowedOrigins("*")
.allowCredentials(true);r.addMapping("/api/**")
.allowedOrigins("http://localhost:3000", "https://magazin.ro")
.allowCredentials(true);Cu origini numite, Spring poate trimite originea exactă în antet.
2Ai nevoie de toate subdomeniile
.allowedOrigins("*").allowCredentials(true).allowedOriginPatterns("https://*.magazin.ro").allowCredentials(true)Tiparul acceptă subdomeniile, iar răspunsul conține originea concretă, nu *.
3Nu ai nevoie de credențiale
.allowedOrigins("*").allowCredentials(true) // API public.allowedOrigins("*") // fără cookie-uriPentru un API public fără autentificare prin cookie, * fără credențiale e permis.
Repară eroarea, direct în pagină
Configurarea CORS combină allowedOrigins("*") cu allowCredentials(true), iar Spring real o respinge cu When allowCredentials is true, allowedOrigins cannot contain the special value "*". Permite explicit doar originea http://localhost:3000, păstrând credențialele.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class CosController {
@GetMapping("/api/cos")
List<String> cos() {
return List.of("Mouse x 1");
}
}
@Configuration
class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry r) {
r.addMapping("/api/**")
.allowedOrigins("*")
.allowCredentials(true);
}
}Tomcat started on port 8080 (http) Started Application GET /api/cos → 200 Access-Control-Allow-Origin: http://localhost:3000 ["Mouse x 1"]
Indiciu
Înlocuiește steaua cu adresa exactă a frontend-ului.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class CosController {
@GetMapping("/api/cos")
List<String> cos() {
return List.of("Mouse x 1");
}
}
@Configuration
class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry r) {
r.addMapping("/api/**")
.allowedOrigins("http://localhost:3000")
.allowCredentials(true);
}
}De ce merge
Cu credențiale, browserul cere ca serverul să numească exact originea acceptată, iar * nu e permis. După reparație, răspunsul conține Access-Control-Allow-Origin: http://localhost:3000, iar cookie-urile pot circula doar între frontend-ul cunoscut și API. Pentru mai multe origini, le listezi pe toate sau folosești allowedOriginPatterns.
Cum o eviți pe viitor
- Ține lista originilor în proprietăți (
app.cors.origini), diferită pe dezvoltare și producție. - Folosește
allowCredentials(true)doar dacă trimiți cookie-uri sau autentificare HTTP din browser. - Pentru subdomenii,
allowedOriginPatterns, nu*. - Testează CORS cu un
Originreal și verifică antetele în DevTools.
Întrebări frecvente
Trimit tokenul în antetul Authorization. Am nevoie de allowCredentials?
Nu. allowCredentials privește cookie-urile și autentificarea gestionată de browser. Antetul Authorization trimis din JavaScript cere doar ca el să fie permis (allowedHeaders).
Laboratorul nu dă eroarea. De ce?
Simulatorul acceptă combinația și trimite *; Spring real o refuză. În exercițiu vezi diferența în antetul afișat.
Erori înrudite
Access to fetch at 'http://localhost:8080/api/produse' from origin 'http://localhost:3000' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. Browserul a blocat răspunsul pentru că frontend-ul (localhost:3000) și API-ul (localhost:8080) au origini diferite, iar serverul nu a trimis antetul Access-Control-Allow-Origin. Configurează CORS în Spring: addCorsMappings sau @CrossOrigin, cu originea exactă a frontend-ului. Invalid CORS request Serverul are CORS configurat, dar originea din care vine cererea nu e în lista permisă, așa că Spring răspunde 403 cu textul Invalid CORS request. Adaugă originea exactă a frontend-ului (schemă, domeniu și port) în allowedOrigins. Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
