...
Eroare ASP.NET Core · Controllere, validare și ProblemDetails

{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.5","title":"Not Found","status":404}

Pe scurt

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

Greșit
C#
if (produs is null) return NotFound();
Corect
C#
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

Greșit
C#
return NotFound();
Corect
C#
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ă tu

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

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

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 detail informaț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

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