...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Content-Type 'text/plain;charset=UTF-8' is not supported

Pe scurt

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

Greșit
JAVA
fetch('/api/note', { method: 'POST', body: JSON.stringify(nota) })
Corect
JAVA
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

Greșit
JAVA
@PostMapping("/comenzi/{id}/nota")
String nota(@PathVariable long id, @RequestBody Nota nota) { ... }
Corect
JAVA
@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

Greșit
JAVA
<form method="post" action="/abonare">...
@RequestBody Abonare a
Corect
JAVA
@ModelAttribute Abonare a

Formularele trimit application/x-www-form-urlencoded, citit cu @ModelAttribute.

Repară tu

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.

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

Alte forme ale mesajului

  • Content-Type 'application/x-www-form-urlencoded;charset=UTF-8' is not supported
  • Content 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ă consumes pe 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

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