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

Request method 'POST' is not supported

Pe scurt

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

Greșit
JAVA
@GetMapping("/produse")
List<Produs> toate() { ... }
// clientul: POST /produse
Corect
JAVA
@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

Greșit
JAVA
@GetMapping("/comenzi/{id}/anulare")
void anuleaza(@PathVariable long id) { ... }
Corect
JAVA
@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

Greșit
JAVA
http://localhost:8080/comenzi   // în bara de adrese = GET
Corect
JAVA
curl -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ă tu

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.

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 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
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • Request method 'GET' is not supported
  • Request method 'DELETE' is not supported
  • Resolved [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 @RequestMapping fă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

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