HttpClientErrorException$Unauthorized: 401 Unauthorized: "{"status":401,"error":"Unauthorized","path":"/stoc/A1/rezervat"}"
Serviciul apelat cere autentificare, iar cererea clientului tău nu avea credențiale valide (antet Authorization lipsă, token expirat sau greșit). RestClient transformă 401 în HttpClientErrorException$Unauthorized. Trimite antetul cerut, de preferat configurat o singură dată pe client.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un 401 Unauthorized de la alt serviciu înseamnă că acesta nu te-a putut identifica: cererea nu avea antetul Authorization, tokenul era expirat, avea alt format (Bearer lipsă) sau era emis pentru alt destinatar (audience). RestClient și RestTemplate aruncă HttpClientErrorException$Unauthorized, Feign aruncă FeignException$Unauthorized.
Nu confunda cu 403 Forbidden: la 403, serviciul știe cine ești, dar nu ai dreptul la acea resursă (rol sau scope lipsă).
În apelurile între servicii, autentificarea se face de obicei cu:
- un token de serviciu (OAuth2 client credentials), obținut și reînnoit automat;
- propagarea tokenului utilizatorului primit de serviciul tău;
- o cheie internă, într-un antet, în rețele închise.
Oricare ar fi, configureaz-o o singură dată (defaultHeader, un interceptor sau OAuth2ClientHttpRequestInterceptor), nu la fiecare apel. Secretele stau în variabile de mediu, nu în cod.
De ce apare: cauzele frecvente
1Lipsește antetul
RestClient.builder().baseUrl(url).build();RestClient.builder()
.baseUrl(url)
.defaultHeader("Authorization", "Bearer " + token)
.build();defaultHeader adaugă antetul la fiecare cerere a clientului.
2Lipsește prefixul Bearer
.defaultHeader("Authorization", token).defaultHeader("Authorization", "Bearer " + token)Schema Bearer face parte din valoarea antetului.
3Token expirat, obținut o singură dată
String token = obtineToken(); // la pornire.requestInterceptor(new OAuth2ClientHttpRequestInterceptor(manager))Interceptorul OAuth2 reînnoiește tokenul automat.
Repară eroarea, direct în pagină
Endpoint-ul /stoc/{cod}/rezervat acceptă doar cereri cu antetul Authorization: Bearer magazin-intern, iar magazinul primește 500 cu 401 Unauthorized. Adaugă antetul pe clientul din StocClient cu defaultHeader, ca să plece la fiecare cerere.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.*;
import org.springframework.web.server.ResponseStatusException;
import java.util.*;
/* StocApp.properties
spring.application.name=stoc
server.port=8081
*/
/* MagazinApp.properties
server.port=8080
server.error.include-message=always
*/
record Stoc(String cod, int bucati) { }
@SpringBootApplication
class StocApp {
public static void main(String[] args) {
SpringApplication.run(StocApp.class, args);
}
@RestController
static class StocController {
private final Map<String, Integer> stoc = Map.of("A1", 5, "B2", 0);
@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable String cod) {
Integer n = stoc.get(cod);
if (n == null) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Cod necunoscut: " + cod);
}
return new Stoc(cod, n);
}
@GetMapping("/stoc/{cod}/rezervat")
Stoc rezervat(@PathVariable String cod, @RequestHeader(value = "Authorization", required = false) String auth) {
if (!"Bearer magazin-intern".equals(auth)) {
throw new ResponseStatusException(HttpStatus.UNAUTHORIZED);
}
return new Stoc(cod, 2);
}
}
}
@SpringBootApplication
class MagazinApp {
public static void main(String[] args) {
SpringApplication.run(MagazinApp.class, args);
}
@Service
static class StocClient {
private final RestClient http = RestClient.builder().baseUrl("http://localhost:8081").build();
Stoc stoc(String cod) {
return http.get().uri("/stoc/{cod}/rezervat", cod).retrieve().body(Stoc.class);
}
}
@RestController
static class ProdusController {
private final StocClient stoc;
ProdusController(StocClient stoc) {
this.stoc = stoc;
}
@GetMapping("/produse/{cod}/stoc")
Stoc stoc(@PathVariable String cod) {
return stoc.stoc(cod);
}
}
}Tomcat started on port 8081 (http)
Started StocApp
Tomcat started on port 8080 (http)
Started MagazinApp
GET /produse/A1/stoc → 200
{"cod":"A1","bucati":2}Indiciu
RestClient.builder().baseUrl(...).defaultHeader("Authorization", "Bearer magazin-intern").build()
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.*;
import org.springframework.web.server.ResponseStatusException;
import java.util.*;
/* StocApp.properties
spring.application.name=stoc
server.port=8081
*/
/* MagazinApp.properties
server.port=8080
server.error.include-message=always
*/
record Stoc(String cod, int bucati) { }
@SpringBootApplication
class StocApp {
public static void main(String[] args) {
SpringApplication.run(StocApp.class, args);
}
@RestController
static class StocController {
private final Map<String, Integer> stoc = Map.of("A1", 5, "B2", 0);
@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable String cod) {
Integer n = stoc.get(cod);
if (n == null) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Cod necunoscut: " + cod);
}
return new Stoc(cod, n);
}
@GetMapping("/stoc/{cod}/rezervat")
Stoc rezervat(@PathVariable String cod, @RequestHeader(value = "Authorization", required = false) String auth) {
if (!"Bearer magazin-intern".equals(auth)) {
throw new ResponseStatusException(HttpStatus.UNAUTHORIZED);
}
return new Stoc(cod, 2);
}
}
}
@SpringBootApplication
class MagazinApp {
public static void main(String[] args) {
SpringApplication.run(MagazinApp.class, args);
}
@Service
static class StocClient {
private final RestClient http = RestClient.builder()
.baseUrl("http://localhost:8081")
.defaultHeader("Authorization", "Bearer magazin-intern")
.build();
Stoc stoc(String cod) {
return http.get().uri("/stoc/{cod}/rezervat", cod).retrieve().body(Stoc.class);
}
}
@RestController
static class ProdusController {
private final StocClient stoc;
ProdusController(StocClient stoc) {
this.stoc = stoc;
}
@GetMapping("/produse/{cod}/stoc")
Stoc stoc(@PathVariable String cod) {
return stoc.stoc(cod);
}
}
}De ce merge
Serviciul de stoc verifică antetul Authorization și răspunde 401 când lipsește, iar RestClient transforma 401 în excepție. Cu defaultHeader, antetul pleacă automat la fiecare cerere a clientului, fără să-l repeți la fiecare apel. Într-un proiect real, tokenul ar veni dintr-o variabilă de mediu, nu ar fi scris în cod.
Alte forme ale mesajului
org.springframework.web.client.HttpClientErrorException$Unauthorized: 401 Unauthorized: [no body]feign.FeignException$Unauthorized: [401 Unauthorized] during [GET] to [...]org.springframework.web.client.HttpClientErrorException$Forbidden: 403 Forbidden: [no body]
Cum o eviți pe viitor
- Configurează autentificarea o singură dată pe client:
defaultHeadersau interceptor. - Pentru OAuth2, folosește client credentials cu reînnoire automată a tokenului.
- Ține secretele în variabile de mediu sau într-un manager de secrete.
- Tratează 401 separat de 403 în jurnale și alerte.
Întrebări frecvente
Care e diferența dintre 401 și 403?
401: serviciul nu știe cine ești (credențiale lipsă sau invalide). 403: știe cine ești, dar nu ai drept la resursă.
Unde țin tokenul sau cheia?
În proprietăți alimentate din variabile de mediu (${STOC_TOKEN}) sau într-un manager de secrete, niciodată în cod.
Erori înrudite
HttpClientErrorException$NotFound: 404 Not Found: "{"status":404,"error":"Not Found","path":"/stoc/Z9"}" Serviciul apelat a răspuns 404, iar RestClient/RestTemplate transformă orice răspuns 4xx într-o excepție HttpClientErrorException. Neprinsă, devine 500 în serviciul tău. Verifică URL-ul apelat și tratează 404 explicit (try/catch sau onStatus), răspunzând clientului tău cu 404. FeignException$NotFound: [404 Not Found] during [GET] to [http://localhost:8081/stoc/Z9] [StocClient#stoc(String)] Clientul Feign a primit 404 de la serviciul apelat și, implicit, aruncă FeignException$NotFound. Neprinsă, devine 500 în serviciul tău. Verifică ruta din interfața @FeignClient și tratează resursa lipsă: prinde excepția, folosește dismiss404 sau un ErrorDecoder propriu. HttpServerErrorException$InternalServerError: 500 Internal Server Error: "{"status":500,"error":"Internal Server Error","path":"/stoc/A1"}" Serviciul apelat a răspuns cu o eroare 5xx, iar RestClient/RestTemplate aruncă HttpServerErrorException. Problema e în celălalt serviciu, dar neprinsă îți strică și răspunsul tău (500). Prinde excepția, răspunde cu 503 sau cu o valoare de rezervă, și investighează jurnalul serviciului apelat. Î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.
