Content-Type 'text/plain;charset=UTF-8' is not supported
Clientul trimite corpul cu un Content-Type pe care metoda nu îl poate citi (de exemplu text/plain la un @RequestBody care așteaptă JSON), deci Spring răspunde 415 Unsupported Media Type. Trimite antetul Content-Type: application/json sau primește textul ca String.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
HttpMediaTypeNotSupportedException apare când Spring nu are un convertor care să transforme corpul, în formatul anunțat de antetul Content-Type, în tipul parametrului @RequestBody. Un record sau o clasă se citește din application/json; dacă cererea spune text/plain sau application/x-www-form-urlencoded, Spring răspunde 415 Unsupported Media Type, cu mesajul Content-Type 'text/plain;charset=UTF-8' is not supported.
Cazuri tipice: în Postman ai ales Body > raw, dar ai lăsat tipul „Text” în loc de „JSON”; un fetch trimite JSON.stringify(...) fără antet; un formular HTML trimite application/x-www-form-urlencoded către o metodă cu @RequestBody.
Reparația depinde de intenție: dacă datele sunt JSON, clientul trebuie să trimită Content-Type: application/json; dacă ruta chiar primește text simplu, parametrul trebuie să fie String; pentru formulare, folosește @ModelAttribute sau @RequestParam. Notă: laboratorul răspunde în acest caz cu 400, nu cu 415.
De ce apare: cauzele frecvente
1Clientul nu anunță JSON
fetch('/api/note', { method: 'POST', body: JSON.stringify(nota) })fetch('/api/note', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(nota)
})Fără antet, fetch trimite textul ca text/plain;charset=UTF-8.
2Ruta primește de fapt text simplu
@PostMapping("/comenzi/{id}/nota")
String nota(@PathVariable long id, @RequestBody Nota nota) { ... }@PostMapping(value = "/comenzi/{id}/nota", consumes = "text/plain")
String nota(@PathVariable long id, @RequestBody String nota) { ... }Un String se poate citi din orice text; un record are nevoie de JSON.
3Formular HTML către @RequestBody
<form method="post" action="/abonare">...
@RequestBody Abonare a@ModelAttribute Abonare aFormularele trimit application/x-www-form-urlencoded, citit cu @ModelAttribute.
Repară eroarea, direct în pagină
Aplicația de livrări trimite nota unei comenzi ca text simplu (Content-Type: text/plain), dar ruta POST /comenzi/{id}/nota așteaptă un record JSON și refuză cererea. Ruta trebuie să primească text simplu: schimbă parametrul @RequestBody ca să citească textul ca String, ca răspunsul să fie Comanda 7: Livrare după ora 18.
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);
}
}
record Nota(String text) {
}
@RestController
class NotaController {
@PostMapping("/comenzi/{id}/nota")
String nota(@PathVariable long id, @RequestBody Nota nota) {
return "Comanda " + id + ": " + nota.text();
}
}Tomcat started on port 8080 (http) Started Application POST /comenzi/7/nota → 200 Comanda 7: Livrare după ora 18
Indiciu
Un parametru @RequestBody de tip String primește tot corpul, ca text.
Reparația
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 NotaController {
@PostMapping("/comenzi/{id}/nota")
String nota(@PathVariable long id, @RequestBody String nota) {
return "Comanda " + id + ": " + nota;
}
}De ce merge
Un record se poate citi doar din JSON, iar cererea anunța text/plain. Spring Boot real răspunde aici 415 Unsupported Media Type (laboratorul, 400), pentru că nu are convertor de la text simplu la Nota. Un @RequestBody String acceptă orice text, deci nota ajunge întreagă în metodă. Dacă intenția era JSON, reparația ar fi fost în client: antetul Content-Type: application/json.
Alte forme ale mesajului
Content-Type 'application/x-www-form-urlencoded;charset=UTF-8' is not supportedContent type 'text/plain;charset=UTF-8' not supported
Cum o eviți pe viitor
- Setează mereu
Content-Type: application/jsonîn clienții care trimit JSON. - În Postman, alege la Body tipul JSON, nu Text.
- Declară
consumespe rutele care primesc alt format decât JSON, ca intenția să fie clară. - Testează rutele cu MockMvc și
contentType(MediaType.APPLICATION_JSON).
Întrebări frecvente
Care e diferența față de 406 Not Acceptable?
415 privește formatul trimis de client (Content-Type). 406 privește formatul cerut în răspuns (Accept) pe care serverul nu îl poate produce.
De ce în Spring Boot 2 mesajul era puțin diferit?
Versiunile mai vechi scriau Content type '...' not supported. Cauza și reparația sunt aceleași.
Erori înrudite
Required request body is missing Metoda are un parametru @RequestBody, dar cererea a venit fără corp (adesea datele erau în query sau cererea era GET), deci Spring răspunde 400. Trimite JSON-ul în corpul cererii sau citește datele cu @RequestParam dacă vin în adresă. JSON parse error: Unrecognized token 'Mouse': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false') Jackson a găsit un cuvânt care nu e o valoare JSON validă, de obicei un text fără ghilimele (Mouse în loc de "Mouse") sau un corp care nu e JSON deloc. Pune textele între ghilimele duble și trimite JSON valid. Request method 'POST' is not supported Calea există, dar nu acceptă metoda HTTP folosită (de exemplu ai doar @GetMapping, iar clientul trimite POST), deci răspunsul este 405 Method Not Allowed. Adaugă metoda potrivită (@PostMapping) sau trimite cererea cu metoda corectă. Î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.
