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

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.

Pe scurt

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

Greșit
JAVA
@RestController
class ProdusController { ... }
Corect
JAVA
@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

Greșit
JAVA
@RestController
class ProdusController { ... }
Corect
JAVA
@CrossOrigin(origins = "http://localhost:3000")
@RestController
class ProdusController { ... }

@CrossOrigin configurează CORS doar pentru acel controller.

3Spring Security blochează preflight-ul

Greșit
JAVA
http.authorizeHttpRequests(a -> a.anyRequest().authenticated());
Corect
JAVA
http.cors(Customizer.withDefaults())
    .authorizeHttpRequests(a -> a.anyRequest().authenticated());

Cu securitate, http.cors() lasă cererile OPTIONS să ajungă la configurarea CORS.

Repară tu

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.

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 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/**
}
După reparație, programul afișează
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/**.

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 în SecurityFilterChain).
  • 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

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