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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Eroarea apare în consola browserului, nu în jurnalul Spring. Politica same-origin interzice unei pagini să citească răspunsuri de la altă origine (schemă + domeniu + port). http://localhost:3000 și http://localhost:8080 diferă prin port, deci sunt origini diferite.
CORS (Cross-Origin Resource Sharing) e mecanismul prin care serverul spune browserului „accept această origine”: răspunsul trebuie să conțină Access-Control-Allow-Origin: http://localhost:3000. Pentru cereri cu Content-Type: application/json, antete proprii sau metode ca PUT/DELETE, browserul trimite întâi o cerere preflight OPTIONS, iar mesajul devine Response to preflight request doesn't pass access control check.
Important: cererea a ajuns la server și poate chiar s-a executat; browserul doar ascunde răspunsul de JavaScript. De aceea în Postman sau curl totul merge: ele nu aplică politica CORS.
De ce apare: cauzele frecvente
1Nicio configurare CORS
@RestController
class ProdusController { ... }@Configuration
class WebConfig implements WebMvcConfigurer {
public void addCorsMappings(CorsRegistry r) {
r.addMapping("/api/**").allowedOrigins("http://localhost:3000");
}
}Configurarea globală adaugă antetul pentru toate rutele /api/**.
2Doar un controller are nevoie de CORS
@RestController
class ProdusController { ... }@CrossOrigin(origins = "http://localhost:3000")
@RestController
class ProdusController { ... }@CrossOrigin configurează CORS doar pentru acel controller.
3Spring Security blochează preflight-ul
http.authorizeHttpRequests(a -> a.anyRequest().authenticated());http.cors(Customizer.withDefaults())
.authorizeHttpRequests(a -> a.anyRequest().authenticated());Cu securitate, http.cors() lasă cererile OPTIONS să ajungă la configurarea CORS.
Repară eroarea, direct în pagină
Aplicația React de pe http://localhost:3000 primește în browser blocked by CORS policy: No 'Access-Control-Allow-Origin' header. Completează WebConfig ca rutele /api/** să accepte această origine; laboratorul afișează antetul Access-Control-Allow-Origin.
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 ProdusController {
@GetMapping("/api/produse")
List<String> produse() {
return List.of("Mouse", "Tastatură");
}
}
@Configuration
class WebConfig implements WebMvcConfigurer {
// TODO: permite originea aplicației React, http://localhost:3000, pe rutele /api/**
}Tomcat started on port 8080 (http) Started Application GET /api/produse → 200 Access-Control-Allow-Origin: http://localhost:3000 ["Mouse","Tastatură"]
Indiciu
Suprascrie addCorsMappings(CorsRegistry r) și adaugă o regulă pentru /api/**.
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 ProdusController {
@GetMapping("/api/produse")
List<String> produse() {
return List.of("Mouse", "Tastatură");
}
}
@Configuration
class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry r) {
r.addMapping("/api/**").allowedOrigins("http://localhost:3000");
}
}De ce merge
Fără configurare CORS, serverul răspundea fără antetul Access-Control-Allow-Origin, iar browserul ascundea răspunsul de aplicația React. Regula din addCorsMappings spune că rutele /api/** acceptă originea http://localhost:3000, deci răspunsul primește antetul, iar browserul îl lasă să treacă. Alte origini rămân blocate. În proiect, citește lista originilor din proprietăți, ca să difere între dezvoltare și producție.
Alte forme ale mesajului
Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at http://localhost:8080/api/produse. (Reason: CORS header 'Access-Control-Allow-Origin' missing).
Cum o eviți pe viitor
- Configurează CORS o singură dată, global, în
WebMvcConfigurer(sau înSecurityFilterChain). - Listează originile exacte ale frontend-urilor, din proprietăți, diferite pe medii.
- Nu folosi
*pentru API-uri cu autentificare. - În dezvoltare, un proxy în frontend (Vite, CRA) evită CORS cu totul.
- Verifică în DevTools, tab Network, antetele răspunsului și cererea preflight.
Întrebări frecvente
De ce merge în Postman și nu în browser?
CORS e o regulă a browserului. Postman și curl nu o aplică, deci văd răspunsul chiar dacă antetul lipsește.
Pot rezolva din frontend?
Nu cu adevărat: antetul trebuie trimis de server. Un proxy de dezvoltare face ca cererile să pară de la aceeași origine, dar în producție tot serverul decide.
Erori înrudite
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. 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.
