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

Could not extract response: no suitable HttpMessageConverter found for response type [class Stoc] and content type [text/plain;charset=UTF-8]

Pe scurt

Clientul HTTP a primit un răspuns pe care nu-l poate transforma în tipul cerut: de obicei text sau HTML în loc de JSON, ori un JSON cu altă structură. Verifică URL-ul (poate nimerește o pagină sau alt endpoint) și ce întoarce efectiv serviciul apelat.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

RestClientException: Could not extract response: no suitable HttpMessageConverter found for response type [class Stoc] and content type [text/plain;charset=UTF-8] (sau Error while extracting response for type [class Stoc] and content type [application/json], când conversia JSON pornește, dar eșuează) apare după ce răspunsul a sosit cu succes: Spring caută un convertor care să transforme corpul în clasa cerută și nu găsește unul potrivit sau conversia eșuează.

Cauze frecvente:

  • URL-ul duce la alt endpoint, care întoarce text (o etichetă, un mesaj) în loc de JSON;
  • un proxy, un gateway sau o pagină de login întorc HTML (un 200 cu pagina de autentificare e clasic);
  • JSON-ul are altă structură: o listă în loc de obiect sau un obiect învelit ({"data": {...}});
  • serviciul trimite JSON, dar cu Content-Type: text/plain.

Ca să vezi ce primești, cere temporar corpul ca String.class și afișează-l. Mesajul îți spune deja tipul de conținut.

De ce apare: cauzele frecvente

1Endpoint greșit, care întoarce text

Greșit
JAVA
.uri("/stoc/{cod}/eticheta", cod).retrieve().body(Stoc.class)
Corect
JAVA
.uri("/stoc/{cod}", cod).retrieve().body(Stoc.class)

Endpoint-ul JSON întoarce obiectul așteptat.

2Listă citită ca obiect

Greșit
JAVA
.body(Stoc.class) // răspunsul e [ {...}, {...} ]
Corect
JAVA
.body(new ParameterizedTypeReference<List<Stoc>>() {})

Tipul cerut trebuie să corespundă structurii JSON.

3Pagină de login în loc de date

Greșit
JAVA
// apel fără autentificare către un serviciu securizat
Corect
JAVA
.header("Authorization", "Bearer " + token)

Fără token, unele servicii redirecționează spre o pagină HTML de login.

Repară tu

Repară eroarea, direct în pagină

Magazinul primește 500 cu Error while extracting response for type [Stoc]: StocClient cheamă endpoint-ul /eticheta, care întoarce un text, nu JSON. Uită-te la rutele din StocController și cheamă endpoint-ul care întoarce un obiect Stoc.

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}/eticheta")
        String eticheta(@PathVariable String cod) {
            return cod + ": " + stoc.getOrDefault(cod, 0) + " bucati";
        }
    }
}

@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}/eticheta", 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":5}
Indiciu

Ruta /stoc/{cod} întoarce JSON; /stoc/{cod}/eticheta întoarce text.

Alte forme ale mesajului

  • org.springframework.web.client.RestClientException: Error while extracting response for type [class Stoc] and content type [application/json]
  • no suitable HttpMessageConverter found for response type [class Stoc] and content type [text/html;charset=UTF-8]
  • JSON parse error: Cannot deserialize value of type `Stoc` from Array value

Cum o eviți pe viitor

  • Verifică cu un client HTTP (curl, Postman) ce întoarce exact endpoint-ul apelat.
  • Definește contractul dintre servicii (OpenAPI) și generează clienții din el.
  • Cere Accept: application/json explicit.
  • Testează clientul cu răspunsuri reale salvate, inclusiv cele de eroare.

Întrebări frecvente

Cum văd corpul care nu s-a putut converti?

Cere-l temporar ca String.class și afișează-l, sau activează jurnalizarea clientului HTTP.

Ajută dacă adaug un convertor?

Doar dacă formatul e corect, dar Content-Type e greșit. Dacă serviciul trimite text sau HTML, problema e URL-ul sau serviciul, nu convertorul.

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.