405 Method Not Allowed
Calea există, dar nu pentru metoda HTTP folosită: de exemplu există GET /produse, iar clientul trimite POST /produse. Adaugă endpoint-ul pentru metoda respectivă (MapPost, MapPut, MapDelete) sau corectează metoda din client.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Rutarea din ASP.NET Core ține cont de două lucruri: calea și metoda HTTP. Dacă găsește rute pentru cale, dar niciuna nu acceptă metoda cererii, răspunde 405 Method Not Allowed (cu antetul Allow care listează metodele permise, de exemplu Allow: GET), nu 404. Asta e de fapt un indiciu util: URL-ul e corect, metoda nu.
Cauze tipice: ai scris MapGet în loc de MapPost pentru creare, clientul trimite PUT iar serverul are MapPatch, un formular HTML trimite POST către un endpoint GET, sau la controllere atributul e [HttpGet] pe o acțiune care ar trebui să fie [HttpDelete]. Tot 405 apare la cererile OPTIONS din browser dacă CORS nu e configurat și nu există niciun endpoint pentru OPTIONS.
De ce apare: cauzele frecvente
1Lipsește endpoint-ul pentru metoda cerută
app.MapGet("/produse", () => produse);
// clientul trimite POST /produseapp.MapGet("/produse", () => produse);
app.MapPost("/produse", (Produs p) => { produse.Add(p); return Results.Created($"/produse/{p.Id}", p); });Fiecare metodă HTTP are nevoie de propriul endpoint pe aceeași cale.
2Metoda greșită pe endpoint
app.MapPatch("/produse/{id:int}", (int id, Produs p) => Results.NoContent());
// clientul trimite PUTapp.MapPut("/produse/{id:int}", (int id, Produs p) => Results.NoContent());PUT (înlocuire completă) și PATCH (modificare parțială) sunt metode diferite pentru rutare.
3Atributul greșit în controller
[HttpGet("{id:int}")]
public IActionResult Sterge(int id) => NoContent();[HttpDelete("{id:int}")]
public IActionResult Sterge(int id) => NoContent();Numele acțiunii nu contează pentru metoda HTTP; contează atributul.
Repară eroarea, direct în pagină
Aplicația are lista de rezervări, dar adăugarea unei rezervări cu POST /rezervari primește 405 Method Not Allowed. Adaugă endpoint-ul care primește rezervarea din corp, îi dă id-ul următor și răspunde 201 Created cu Location: /rezervari/{id}.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var rezervari = new List<Rezervare> { new(1, "Ana", 2) };
app.MapGet("/rezervari", () => rezervari);
// TODO: POST /rezervari -> 201 Created cu Location /rezervari/{id}
app.Run();
public record Rezervare(int Id, string Nume, int Persoane);
public record RezervareNoua(string Nume, int Persoane);POST /rezervari → 201 Created
Location: /rezervari/2
{"id":2,"nume":"Mihai","persoane":4}
GET /rezervari → 200 OK
[{"id":1,"nume":"Ana","persoane":2},{"id":2,"nume":"Mihai","persoane":4}]Indiciu
Calea există deja pentru GET; aceeași cale are nevoie de un endpoint pentru POST.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var rezervari = new List<Rezervare> { new(1, "Ana", 2) };
app.MapGet("/rezervari", () => rezervari);
app.MapPost("/rezervari", (RezervareNoua date) =>
{
var rezervare = new Rezervare(rezervari.Count + 1, date.Nume, date.Persoane);
rezervari.Add(rezervare);
return Results.Created($"/rezervari/{rezervare.Id}", rezervare);
});
app.Run();
public record Rezervare(int Id, string Nume, int Persoane);
public record RezervareNoua(string Nume, int Persoane);De ce merge
405 însemna că /rezervari exista doar pentru GET. MapPost pe aceeași cale adaugă al doilea endpoint, iar parametrul RezervareNoua date se citește din corpul JSON. Handler-ul construiește rezervarea cu id-ul următor (rezervari.Count + 1), o adaugă și întoarce Results.Created, care pune statusul 201 și antetul Location.
Alte forme ale mesajului
HTTP/1.1 405 Method Not Allowed (Allow: GET)405 Method Not Allowed la cererea OPTIONS (preflight CORS)
Cum o eviți pe viitor
- Pentru fiecare resursă, scrie lista de operații (GET listă, GET după id, POST, PUT, DELETE) și verifică că fiecare are endpoint-ul ei.
- Grupează endpoint-urile resursei într-un
MapGroup, ca să le vezi împreună. - Când primești 405, citește antetul
Allowdin răspuns: îți spune ce metode acceptă calea.
Întrebări frecvente
De ce 405 și nu 404?
Pentru că rutarea a găsit calea, doar că pentru alte metode. 405 îți spune că URL-ul e corect și că trebuie schimbată metoda (sau adăugat endpoint-ul).
MapMethods la ce folosește?
Pentru același handler pe mai multe metode, de exemplu app.MapMethods("/ping", new[] { "GET", "HEAD" }, () => "pong").
Erori înrudite
404 Not Found (nicio rută nu se potrivește cu calea cererii) ASP.NET Core nu a găsit niciun endpoint pentru calea cererii, așa că răspunde 404 fără corp. Compară caracter cu caracter calea cerută cu rutele din MapGet / MapGroup / [Route]: o literă în plus, un prefix uitat sau un singular în loc de plural sunt cele mai dese cauze. Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple endpoints. Matches: Două rute se potrivesc la fel de bine cu aceeași cerere, de exemplu /clienti/{id} și /clienti/{email}, iar ASP.NET Core nu poate alege și răspunde 500. Fă rutele distincte: o constrângere ({id:int}) sau un segment fix diferit (/clienti/email/{email}). 415 Unsupported Media Type Endpoint-ul așteaptă JSON, dar cererea a venit cu alt Content-Type (text/plain, form, XML sau fără antet). Trimite corpul cu Content-Type: application/json, de exemplu cu PostAsJsonAsync sau new StringContent(json, Encoding.UTF8, "application/json"). Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
