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

{"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."]}}

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Atributul [ApiController] adaugă un filtru care verifică ModelState înainte de acțiune. Dacă model binding-ul sau validarea (DataAnnotations, tipuri non-nullable) au găsit probleme, acțiunea nu mai rulează, iar clientul primește 400 cu un corp standard application/problem+json:

  • type: link spre secțiunea 400 din RFC 9110;
  • title: One or more validation errors occurred.;
  • status: 400;
  • errors: un dicționar câmp → listă de mesaje (de exemplu "Cantitate": ["The field Cantitate must be between 1 and 100."]);
  • traceId, în aplicația reală.

Cheile din errors sunt numele proprietăților (Cantitate), căi JSON pentru erorile de format ($.pret) sau numele parametrului (comanda) când tot corpul e invalid. De aceea un breakpoint în acțiune nu e atins: validarea a oprit cererea înainte.

De ce apare: cauzele frecvente

1Datele încalcă o regulă din model

Greșit
C#
public class ArticolCos { [Range(1, 100)] public int Cantitate { get; set; } }
// POST {"cantitate": 0}
Corect
C#
// POST {"cantitate": 2}

Regula e corectă, datele nu: clientul trebuie să trimită o cantitate între 1 și 100.

2Vrei alt format pentru erori

Greșit
C#
builder.Services.AddControllers();
Corect
C#
builder.Services.AddControllers().ConfigureApiBehaviorOptions(o =>
    o.InvalidModelStateResponseFactory = ctx => new BadRequestObjectResult(new
    {
        mesaj = "Date invalide",
        campuri = ctx.ModelState.Where(e => e.Value!.Errors.Count > 0).Select(e => e.Key)
    }));

InvalidModelStateResponseFactory înlocuiește răspunsul automat, păstrând validarea.

3Vrei să tratezi singur ModelState

Greșit
C#
[HttpPost]
public IActionResult Adauga(ArticolCos a)
{
    if (!ModelState.IsValid) return BadRequest("Mesajul meu"); // nu ajunge aici
    ...
}
Corect
C#
builder.Services.AddControllers()
    .ConfigureApiBehaviorOptions(o => o.SuppressModelStateInvalidFilter = true);

Cu [ApiController], verificarea manuală nu se execută niciodată, pentru că filtrul automat răspunde înainte. O activezi doar dezactivând filtrul.

Repară tu

Repară eroarea, direct în pagină

Aplicația mobilă a magazinului nu știe să citească ValidationProblemDetails și așteaptă erorile în forma {"mesaj":"Date invalide","campuri":[...]}. Configurează InvalidModelStateResponseFactory ca POST /api/cos cu cantitatea 0 să răspundă 400 în acest format, fără să schimbi validarea.

Codul care dă eroarea
C#
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers(); // TODO: format propriu pentru erorile de validare
var app = builder.Build();
app.MapControllers();
app.Run();



public class ArticolCos
{
    public string Produs { get; set; } = "";
    [Range(1, 100)] public int Cantitate { get; set; }
}

[ApiController]
[Route("api/cos")]
public class CosController : ControllerBase
{
    [HttpPost]
    public IActionResult Adauga(ArticolCos articol) => Ok($"Adăugat: {articol.Cantitate} x {articol.Produs}");
}
După reparație, programul afișează
POST /api/cos → 400 Bad Request
{"mesaj":"Date invalide","campuri":["Cantitate"]}
POST /api/cos → 200 OK
Adăugat: 2 x Mouse
Indiciu

AddControllers().ConfigureApiBehaviorOptions(o => o.InvalidModelStateResponseFactory = ctx => new BadRequestObjectResult(...)).

Alte forme ale mesajului

  • {"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Nume":["The Nume field is required."]},"traceId":"00-a1b2...-00"}
  • {"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"One or more validation errors occurred.","status":400,"errors":{...}}

Cum o eviți pe viitor

  • Citește întâi errors: îți spune exact câmpul și regula.
  • Documentează regulile în OpenAPI (Swagger le afișează din DataAnnotations).
  • Dacă clientul are nevoie de alt format, folosește InvalidModelStateResponseFactory, nu dezactiva validarea.
  • Scrie teste care trimit date invalide și verifică 400 și cheile din errors.

Întrebări frecvente

De ce breakpoint-ul din acțiune nu e atins?

Pentru că filtrul automat al lui [ApiController] răspunde 400 înainte de acțiune. Pune breakpoint într-un filtru sau citește corpul răspunsului.

De ce unele răspunsuri au rfc7231 și altele rfc9110?

Versiunile vechi de ASP.NET Core foloseau link-uri spre RFC 7231. Din .NET 8, link-urile indică RFC 9110, care l-a înlocuit. Structura răspunsului e aceeași.

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.