...
Eroare Spring Boot · Apeluri între servicii și Spring Cloud

HttpClientErrorException$Unauthorized: 401 Unauthorized: "{"status":401,"error":"Unauthorized","path":"/stoc/A1/rezervat"}"

Pe scurt

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

Greșit
JAVA
RestClient.builder().baseUrl(url).build();
Corect
JAVA
RestClient.builder()
    .baseUrl(url)
    .defaultHeader("Authorization", "Bearer " + token)
    .build();

defaultHeader adaugă antetul la fiecare cerere a clientului.

2Lipsește prefixul Bearer

Greșit
JAVA
.defaultHeader("Authorization", token)
Corect
JAVA
.defaultHeader("Authorization", "Bearer " + token)

Schema Bearer face parte din valoarea antetului.

3Token expirat, obținut o singură dată

Greșit
JAVA
String token = obtineToken(); // la pornire
Corect
JAVA
.requestInterceptor(new OAuth2ClientHttpRequestInterceptor(manager))

Interceptorul OAuth2 reînnoiește tokenul automat.

Repară tu

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.

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

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: defaultHeader sau 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

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