Required request header 'X-API-Key' for method parameter type String is not present
Metoda cere un antet HTTP cu @RequestHeader, iar cererea nu îl are, deci Spring răspunde 400. Trimite antetul din client sau fă-l opțional cu required = false / defaultValue.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
@RequestHeader("X-API-Key") String cheie citește antetul X-API-Key din cerere. Ca și @RequestParam, este implicit obligatoriu. Dacă antetul lipsește, Spring aruncă MissingRequestHeaderException și răspunde 400 Bad Request, cu mesajul Required request header 'X-API-Key' for method parameter type String is not present.
Motivele obișnuite: clientul nu trimite antetul (lipsă în Postman, în codul front-end sau într-un test), numele e scris diferit (antetele nu țin cont de majuscule, dar X-Api-Key față de X-API-Key-Id sunt nume diferite), sau un proxy din fața aplicației elimină antetele necunoscute.
Dacă antetul e opțional (limba preferată, un identificator de corelare), dă-i defaultValue sau required = false. Dacă e obligatoriu pentru securitate, mai bine îl verifici într-un filtru și răspunzi 401, nu 400.
De ce apare: cauzele frecvente
1Antet opțional declarat obligatoriu
@GetMapping("/produse")
List<Produs> toate(@RequestHeader("Accept-Language") String limba) { ... }@GetMapping("/produse")
List<Produs> toate(@RequestHeader(value = "Accept-Language", defaultValue = "ro") String limba) { ... }Cu defaultValue, lipsa antetului nu mai e o eroare.
2Clientul nu trimite antetul
curl http://localhost:8080/rapoartecurl -H 'X-API-Key: cheie-demo' http://localhost:8080/rapoarteAntetul cerut trebuie adăugat explicit în fiecare cerere.
Repară eroarea, direct în pagină
GET /produse răspunde 400: Required request header 'Accept-Language' for method parameter type String is not present. Limba e opțională: fă antetul opțional, cu valoarea implicită ro, ca cererea fără antet să răspundă Produse (ro), iar cea cu Accept-Language: en să răspundă Produse (en).
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
@GetMapping("/produse")
String produse(@RequestHeader("Accept-Language") String limba) {
return "Produse (" + limba + ")";
}
}Tomcat started on port 8080 (http) Started Application GET /produse → 200 Produse (ro) GET /produse → 200 Produse (en)
Indiciu
@RequestHeader are, ca @RequestParam, atributul defaultValue.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
@GetMapping("/produse")
String produse(@RequestHeader(value = "Accept-Language", defaultValue = "ro") String limba) {
return "Produse (" + limba + ")";
}
}De ce merge
@RequestHeader fără atribute cere antetul în orice cerere, așa că lipsa lui oprea cererea cu 400 înainte de metodă. Cu value = "Accept-Language", defaultValue = "ro", antetul devine opțional: când lipsește primești ro, când e trimis primești valoarea lui. Când folosești mai multe atribute, numele antetului trebuie scris explicit cu value.
Alte forme ale mesajului
Required request header 'Authorization' for method parameter type String is not presentMissingRequestHeaderException
Cum o eviți pe viitor
- Documentează antetele obligatorii ale API-ului.
- Dă valori implicite antetelor opționale.
- Pentru autentificare, folosește un filtru care răspunde 401 cu un mesaj clar, în loc de
@RequestHeaderîn fiecare metodă. - Testează și cererea fără antet, nu doar cazul fericit.
- Verifică numele exact al antetului: Spring îl compară fără majuscule, dar cratimele contează.
Întrebări frecvente
Contează majusculele în numele antetului?
Nu: HTTP tratează numele antetelor fără să țină cont de majuscule, iar Spring la fel.
De ce 400 și nu 401?
Pentru Spring MVC, lipsa unui antet cerut e o cerere incompletă. Dacă antetul înseamnă autentificare, tratează-l într-un filtru și răspunde 401.
Erori înrudite
Required request parameter 'pagina' for method parameter type int is not present Metoda are un parametru @RequestParam obligatoriu, iar cererea nu îl conține în query (?pagina=1), deci Spring răspunde 400. Trimite parametrul, sau fă-l opțional cu defaultValue = "0" / required = false. Required request body is missing Metoda are un parametru @RequestBody, dar cererea a venit fără corp (adesea datele erau în query sau cererea era GET), deci Spring răspunde 400. Trimite JSON-ul în corpul cererii sau citește datele cu @RequestParam dacă vin în adresă. Request method 'POST' is not supported Calea există, dar nu acceptă metoda HTTP folosită (de exemplu ai doar @GetMapping, iar clientul trimite POST), deci răspunsul este 405 Method Not Allowed. Adaugă metoda potrivită (@PostMapping) sau trimite cererea cu metoda corectă. Î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.
