...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Required request header 'X-API-Key' for method parameter type String is not present

Pe scurt

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

Greșit
JAVA
@GetMapping("/produse")
List<Produs> toate(@RequestHeader("Accept-Language") String limba) { ... }
Corect
JAVA
@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

Greșit
JAVA
curl http://localhost:8080/rapoarte
Corect
JAVA
curl -H 'X-API-Key: cheie-demo' http://localhost:8080/rapoarte

Antetul cerut trebuie adăugat explicit în fiecare cerere.

Repară tu

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

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

Alte forme ale mesajului

  • Required request header 'Authorization' for method parameter type String is not present
  • MissingRequestHeaderException

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

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