Could not extract response: no suitable HttpMessageConverter found for response type [class Stoc] and content type [text/plain;charset=UTF-8]
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
200cu 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
.uri("/stoc/{cod}/eticheta", cod).retrieve().body(Stoc.class).uri("/stoc/{cod}", cod).retrieve().body(Stoc.class)Endpoint-ul JSON întoarce obiectul așteptat.
2Listă citită ca obiect
.body(Stoc.class) // răspunsul e [ {...}, {...} ].body(new ParameterizedTypeReference<List<Stoc>>() {})Tipul cerut trebuie să corespundă structurii JSON.
3Pagină de login în loc de date
// apel fără autentificare către un serviciu securizat.header("Authorization", "Bearer " + token)Fără token, unele servicii redirecționează spre o pagină HTML de login.
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.
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);
}
}
}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.
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}/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}", 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
Endpoint-ul /eticheta întoarce un text simplu (A1: 5 bucati), cu Content-Type: text/plain. Clientul cerea un Stoc, iar Jackson nu poate construi un obiect dintr-un text. Endpoint-ul /stoc/{cod} întoarce JSON-ul cu câmpurile cod și bucati, deci conversia reușește. Dacă nu știi ce întoarce un endpoint, cere-l o dată ca String și uită-te la corp.
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/jsonexplicit. - 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
Not enough variable values available to expand 'cod' URI-ul are un șablon cu variabile ({cod}), dar apelul nu a primit valori pentru toate. RestClient/RestTemplate nu poate construi URL-ul. Transmite valorile în ordinea variabilelor, ca argumente după șablon, sau într-un Map cu aceleași nume. 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. I/O error on GET request for "http://localhost:8082/stoc/A1": Connection refused Clientul HTTP (RestClient, RestTemplate, Feign) nu s-a putut conecta la serviciul apelat: la adresa și portul din URL nu ascultă nimic. Serviciul e oprit, portul sau gazda sunt greșite, ori în Docker folosești localhost în loc de numele containerului. Verifică URL-ul și că serviciul rulează. Î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.
