{"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.
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
public class ArticolCos { [Range(1, 100)] public int Cantitate { get; set; } }
// POST {"cantitate": 0}// POST {"cantitate": 2}Regula e corectă, datele nu: clientul trebuie să trimită o cantitate între 1 și 100.
2Vrei alt format pentru erori
builder.Services.AddControllers();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
[HttpPost]
public IActionResult Adauga(ArticolCos a)
{
if (!ModelState.IsValid) return BadRequest("Mesajul meu"); // nu ajunge aici
...
}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ă 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.
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}");
}POST /api/cos → 400 Bad Request
{"mesaj":"Date invalide","campuri":["Cantitate"]}
POST /api/cos → 200 OK
Adăugat: 2 x MouseIndiciu
AddControllers().ConfigureApiBehaviorOptions(o => o.InvalidModelStateResponseFactory = ctx => new BadRequestObjectResult(...)).
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
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).ToList()
}));
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}");
}De ce merge
Validarea automată rămâne: [Range(1, 100)] respinge cantitatea 0, iar acțiunea nu rulează. Se schimbă doar felul în care e construit răspunsul: factory-ul primește ActionContext, citește din ModelState câmpurile cu erori și întoarce un BadRequestObjectResult cu forma pe care o așteaptă aplicația mobilă. Cererea validă trece neschimbată.
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
The Descriere field is required. Validarea a găsit o proprietate obligatorie fără valoare. Cu nullable reference types activate, orice string non-nullable (string Descriere) e tratat de controllere ca [Required]. Dacă proprietatea e opțională, declar-o string?; dacă e obligatorie, clientul trebuie să o trimită. The field Cantitate must be between 1 and 5. Valoarea primită e în afara intervalului definit cu [Range(min, max)] pe proprietate, iar validarea automată a răspuns 400. Dacă datele sunt greșite, clientul trimite o valoare în interval; dacă regula e greșită, corectează limitele atributului. The JSON value could not be converted to System.Decimal. Path: $.pret | LineNumber: 0 | BytePositionInLine: 15. System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: de exemplu prețul vine ca "99,50" (cu virgulă) într-un decimal, sau un enum vine ca nume fără JsonStringEnumConverter. Path arată exact câmpul. Trimite formatul corect sau configurează serializatorul să-l accepte. Î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.
