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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spring caută întâi metodele mapate pe cale, apoi verifică metoda HTTP. Dacă există o rută /produse, dar doar pentru GET, o cerere POST /produse primește 405 și excepția HttpRequestMethodNotSupportedException: Request method 'POST' is not supported. În log apare ca WARN ... Resolved [...HttpRequestMethodNotSupportedException: Request method 'POST' is not supported], iar răspunsul are antetul Allow: GET, cu metodele acceptate.
Diferența față de 404 e utilă: 405 înseamnă că adresa e corectă, dar metoda nu. Situații frecvente: ai uitat să scrii metoda @PostMapping, ai folosit @GetMapping dintr-o copiere, clientul trimite PUT în loc de PATCH, sau ai deschis în browser (care trimite mereu GET) o rută de tip POST.
De ce apare: cauzele frecvente
1Lipsește metoda pentru POST
@GetMapping("/produse")
List<Produs> toate() { ... }
// clientul: POST /produse@GetMapping("/produse")
List<Produs> toate() { ... }
@PostMapping("/produse")
Produs adauga(@RequestBody Produs p) { ... }Fiecare metodă HTTP are nevoie de propria mapare pe aceeași cale.
2Adnotare copiată greșit
@GetMapping("/comenzi/{id}/anulare")
void anuleaza(@PathVariable long id) { ... }@PostMapping("/comenzi/{id}/anulare")
void anuleaza(@PathVariable long id) { ... }O acțiune care modifică date se mapează pe POST, nu pe GET.
3Ai deschis un POST în browser
http://localhost:8080/comenzi // în bara de adrese = GETcurl -X POST http://localhost:8080/comenzi -H 'Content-Type: application/json' -d '{...}'Bara de adrese trimite doar GET. Pentru POST folosește Postman, curl sau un formular.
Repară eroarea, direct în pagină
Clientul trimite POST /produse cu un produs nou și primește 405: Request method 'POST' is not supported. Controller-ul are doar listarea. Adaugă ruta de creare, care primește corpul JSON și răspunde cu Adăugat: <nume>, apoi lista trebuie să conțină produsul.
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 ProdusNou(String nume) {
}
@RestController
class ProdusController {
private final List<String> produse = new ArrayList<>(List.of("Mouse"));
@GetMapping("/produse")
List<String> toate() {
return produse;
}
// TODO: POST /produse
}Tomcat started on port 8080 (http) Started Application POST /produse → 200 Adăugat: Tastatură GET /produse → 200 ["Mouse","Tastatură"]
Indiciu
Adaugă o metodă @PostMapping("/produse") cu un parametru @RequestBody.
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);
}
}
record ProdusNou(String nume) {
}
@RestController
class ProdusController {
private final List<String> produse = new ArrayList<>(List.of("Mouse"));
@GetMapping("/produse")
List<String> toate() {
return produse;
}
@PostMapping("/produse")
String adauga(@RequestBody ProdusNou produs) {
produse.add(produs.nume());
return "Adăugat: " + produs.nume();
}
}De ce merge
Calea /produse exista doar pentru GET, așa că Spring a recunoscut adresa, dar a refuzat metoda cu 405. @PostMapping("/produse") adaugă a doua metodă pe aceeași cale. Spring alege acum metoda Java după verbul HTTP: GET listează, POST adaugă. Într-un API real, crearea răspunde de obicei cu 201 și antetul Location, folosind ResponseEntity.created(...).
Alte forme ale mesajului
Request method 'GET' is not supportedRequest method 'DELETE' is not supportedResolved [org.springframework.web.HttpRequestMethodNotSupportedException: Request method 'POST' is not supported]
Cum o eviți pe viitor
- Scrie pentru fiecare resursă un tabel simplu: metodă, cale, ce face.
- Folosește adnotările specifice (
@GetMapping,@PostMapping,@PutMapping,@DeleteMapping) în loc de@RequestMappingfără metodă. - Testează cu Postman sau cu MockMvc, unde alegi explicit metoda.
- Tratează
HttpRequestMethodNotSupportedExceptionîn advice doar dacă vrei alt format de răspuns; codul 405 e deja corect.
Întrebări frecvente
De ce primesc 405 și nu 404?
Pentru că ruta există, dar nu pentru metoda trimisă. E un indiciu bun: adresa e corectă, problema e la metodă.
Ce e antetul Allow din răspuns?
Lista metodelor acceptate pe acea cale, de exemplu Allow: GET, PUT. Te ajută să vezi ce lipsește.
Erori înrudite
No static resource api/produse. În Spring Boot 3.2+, o cerere pentru care nu există niciun controller ajunge la handler-ul de fișiere statice, care nu găsește nimic și răspunde 404 cu NoResourceFoundException. Verifică calea, prefixul @RequestMapping de pe clasă și adnotarea @RestController. Whitelabel Error Page: This application has no explicit mapping for /error, so you are seeing this as a fallback. Este pagina de eroare implicită a Spring Boot, afișată în browser când cererea se termină cu o eroare (de obicei 404: nicio rută pentru adresa cerută, sau 500). Citește type și status de sub ea, apoi verifică ruta, metoda HTTP și logul aplicației. 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ă. Î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.
