...
Eroare Spring Boot · Securitate, filtre și CORS

When allowCredentials is true, allowedOrigins cannot contain the special value "*" since that cannot be set on the "Access-Control-Allow-Origin" response header.

Pe scurt

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

Greșit
JAVA
r.addMapping("/api/**")
    .allowedOrigins("*")
    .allowCredentials(true);
Corect
JAVA
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

Greșit
JAVA
.allowedOrigins("*").allowCredentials(true)
Corect
JAVA
.allowedOriginPatterns("https://*.magazin.ro").allowCredentials(true)

Tiparul acceptă subdomeniile, iar răspunsul conține originea concretă, nu *.

3Nu ai nevoie de credențiale

Greșit
JAVA
.allowedOrigins("*").allowCredentials(true) // API public
Corect
JAVA
.allowedOrigins("*") // fără cookie-uri

Pentru un API public fără autentificare prin cookie, * fără credențiale e permis.

Repară tu

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.

Codul care dă eroarea
JAVA
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);
    }
}
După reparație, programul afișează
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.

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 Origin real ș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

← Toate erorile Spring Boot

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.