{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.5","title":"Not Found","status":404}
Acțiunea a întors NotFound() fără mesaj, iar [ApiController] a transformat răspunsul gol într-un ProblemDetails standard: type cu link spre RFC 9110, title Not Found, status 404. Clientul nu află ce lipsește. Trimite un mesaj: NotFound(new { mesaj = ... }) sau Problem(detail: ..., statusCode: 404).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În controllerele [ApiController], rezultatele cu cod de eroare și fără corp (NotFound(), BadRequest(), Conflict()) sunt completate automat cu un ProblemDetails (comportamentul se numește *client error mapping*). Pentru 404, corpul devine {"type":"https://tools.ietf.org/html/rfc9110#section-15.5.5","title":"Not Found","status":404}, cu Content-Type: application/problem+json (plus traceId în aplicația reală).
Link-ul din type duce la secțiunea din specificația HTTP care descrie codul 404; nu e o adresă a aplicației tale. Răspunsul e corect tehnic, dar sărac: clientul nu află ce resursă lipsește.
Dacă vezi acest corp și te întrebai de unde vine: din NotFound() gol în acțiunea ta, nu din rutare. Un 404 de rutare (nicio acțiune nu se potrivește) are, implicit, corpul gol.
De ce apare: cauzele frecvente
1NotFound() fără mesaj
if (produs is null) return NotFound();if (produs is null) return NotFound(new { mesaj = $"Produsul {id} nu există" });Cu un obiect, corpul răspunsului e obiectul tău, nu ProblemDetails generic.
2Vrei ProblemDetails, dar cu detalii
return NotFound();return Problem(detail: $"Produsul {id} nu există", statusCode: 404, title: "Produs inexistent");Problem(...) păstrează formatul standard și adaugă detail și un titlu clar.
Repară eroarea, direct în pagină
GET /api/produse/9 răspunde cu ProblemDetails generic ("title":"Not Found"), iar aplicația clientului nu știe ce să afișeze. Întoarce Problem(...) cu status 404, titlul Produs inexistent și detaliul Produsul 9 nu există.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public record Produs(int Id, string Nume);
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
private static readonly List<Produs> produse = [new(1, "Laptop"), new(2, "Mouse")];
[HttpGet("{id:int}")]
public IActionResult DupaId(int id)
{
var produs = produse.FirstOrDefault(p => p.Id == id);
if (produs is null) return NotFound(); // TODO: spune ce lipsește
return Ok(produs);
}
}GET /api/produse/1 → 200 OK
{"id":1,"nume":"Laptop"}
GET /api/produse/9 → 404 Not Found
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.5","title":"Produs inexistent","status":404,"detail":"Produsul 9 nu există"}Indiciu
Problem(detail: ..., statusCode: 404, title: ...) e disponibil în ControllerBase.
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public record Produs(int Id, string Nume);
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
private static readonly List<Produs> produse = [new(1, "Laptop"), new(2, "Mouse")];
[HttpGet("{id:int}")]
public IActionResult DupaId(int id)
{
var produs = produse.FirstOrDefault(p => p.Id == id);
if (produs is null)
return Problem(detail: $"Produsul {id} nu există", statusCode: 404, title: "Produs inexistent");
return Ok(produs);
}
}De ce merge
NotFound() fără corp era completat automat cu un ProblemDetails minimal. Cu Problem(...), construiești tu ProblemDetails-ul: același format standard (type, title, status), dar cu un titlu clar și un detail care spune exact ce lipsește. Clientul poate afișa direct mesajul. Formatul rămâne application/problem+json.
Alte forme ale mesajului
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.5","title":"Not Found","status":404,"traceId":"00-..."}{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404}
Cum o eviți pe viitor
- Folosește un singur format de eroare în API (ProblemDetails cu
detail, de exemplu). - Pune în
detailinformația utilă clientului, fără date interne. - Diferențiază „ruta nu există” (rutare) de „resursa nu există” (acțiunea ta), cu mesaje diferite.
- Scrie un test care verifică și corpul răspunsurilor 404, nu doar statusul.
Întrebări frecvente
Pot opri completarea automată?
Da: ConfigureApiBehaviorOptions(o => o.SuppressMapClientErrors = true). Atunci NotFound() întoarce un 404 cu corp gol.
De ce Minimal APIs nu fac asta?
În Minimal APIs, Results.NotFound() are corp gol. Pentru ProblemDetails acolo folosești Results.Problem sau AddProblemDetails cu UseStatusCodePages.
Erori înrudite
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Cantitate":["The field Cantitate must be between 1 and 100."]}} Un controller cu [ApiController] a validat automat datele primite și a găsit erori, așa că a răspuns 400 cu ValidationProblemDetails înainte să ruleze acțiunea. Proprietatea errors spune, pentru fiecare câmp, ce regulă a picat. Corectează datele trimise sau regula greșită din model. System.InvalidOperationException: No route matches the supplied values. CreatedAtAction sau CreatedAtRoute nu a găsit acțiunea/ruta indicată cu valorile date, deci nu poate construi antetul Location. Cauza clasică: acțiunea se numește GetByIdAsync, dar MVC elimină sufixul Async, deci nameof(GetByIdAsync) nu mai corespunde. Folosește numele fără Async sau dezactivează eliminarea sufixului. Î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.
