...
Eroare ASP.NET Core · Rutare: 404, 405 și rute ambigue

405 Method Not Allowed

Pe scurt

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ă

Greșit
C#
app.MapGet("/produse", () => produse);
// clientul trimite POST /produse
Corect
C#
app.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

Greșit
C#
app.MapPatch("/produse/{id:int}", (int id, Produs p) => Results.NoContent());
// clientul trimite PUT
Corect
C#
app.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

Greșit
C#
[HttpGet("{id:int}")]
public IActionResult Sterge(int id) => NoContent();
Corect
C#
[HttpDelete("{id:int}")]
public IActionResult Sterge(int id) => NoContent();

Numele acțiunii nu contează pentru metoda HTTP; contează atributul.

Repară tu

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

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

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 Allow din 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

← Toate erorile ASP.NET Core

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ță 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.