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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul apare în errors din răspunsul 400 al unui controller [ApiController], sub numele proprietății. Are două surse:
- atributul
[Required]pus explicit; - implicit, orice proprietate de tip referință non-nullable, când proiectul are
<Nullable>enable</Nullable>(implicit în proiectele noi). Pentru MVC,string Descriereînseamnă „nu poate fi null”, deci obligatoriu. Valoarea inițială (= "") nu schimbă asta: dacă JSON-ul trimitenullsau dacă proprietatea lipsește dintr-un model construit din formular, validarea pică.
Aceeași regulă se aplică parametrilor acțiunii: un [FromQuery] string termen sau un [FromHeader] string cheie non-nullable e obligatoriu. Rezolvarea e să spui adevărul în tip: string? pentru opțional, string (eventual [Required] cu mesaj propriu) pentru obligatoriu.
De ce apare: cauzele frecvente
1Câmp opțional declarat non-nullable
public class AnuntNou
{
public string Titlu { get; set; } = "";
public string Descriere { get; set; } = "";
}
// POST {"titlu": "Bicicletă", "descriere": null}public class AnuntNou
{
public string Titlu { get; set; } = "";
public string? Descriere { get; set; }
}string? spune că null e o valoare permisă, deci validarea nu mai cere câmpul.
2Câmp chiar obligatoriu, lipsă din cerere
// POST {"descriere": "Ca nouă"} (fără titlu)// POST {"titlu": "Bicicletă", "descriere": "Ca nouă"}Când regula e corectă, repari clientul. Poți da un mesaj mai clar cu [Required(ErrorMessage = "Titlul este obligatoriu")].
3Parametru de query non-nullable
[HttpGet]
public IActionResult Cauta([FromQuery] string termen) => ...[HttpGet]
public IActionResult Cauta([FromQuery] string? termen) => ...Parametrii urmează aceeași regulă: fără ?, termen devine obligatoriu.
Repară eroarea, direct în pagină
POST /api/anunturi respinge cu 400 (The Descriere field is required.) anunțurile fără descriere, deși descrierea trebuie să fie opțională. Schimbă modelul ca anunțul fără descriere să primească 201, iar cel fără titlu să fie respins în continuare.
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 Anunt(int Id, string Titlu, string? Descriere);
public class AnuntNou
{
public string Titlu { get; set; } = "";
// TODO: descrierea trebuie să fie opțională
public string Descriere { get; set; } = "";
}
[ApiController]
[Route("api/anunturi")]
public class AnunturiController : ControllerBase
{
[HttpPost]
public IActionResult Publica(AnuntNou date) => Created($"/api/anunturi/1", new Anunt(1, date.Titlu, date.Descriere));
}POST /api/anunturi → 201 Created
Location: /api/anunturi/1
{"id":1,"titlu":"Bicicletă","descriere":null}
POST /api/anunturi → 400 Bad Request
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Titlu":["The Titlu field is required."]}}Indiciu
Opționalitatea se exprimă în tipul proprietății.
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 Anunt(int Id, string Titlu, string? Descriere);
public class AnuntNou
{
public string Titlu { get; set; } = "";
public string? Descriere { get; set; }
}
[ApiController]
[Route("api/anunturi")]
public class AnunturiController : ControllerBase
{
[HttpPost]
public IActionResult Publica(AnuntNou date) => Created($"/api/anunturi/1", new Anunt(1, date.Titlu, date.Descriere));
}De ce merge
Cu nullable reference types activate, string Descriere era tratat ca obligatoriu de validarea MVC. string? spune că lipsa valorii e permisă, deci validarea nu mai reclamă câmpul. Titlu rămâne string, deci anunțul fără titlu e respins în continuare cu 400, ca înainte.
Alte forme ale mesajului
"errors":{"Titlu":["The Titlu field is required."]}The cheie field is required.
Cum o eviți pe viitor
- Decide pentru fiecare câmp al unui DTO dacă e obligatoriu și scrie asta în tip (
stringsaustring?). - Nu dezactiva nullable reference types ca să scapi de validare.
- Pentru mesaje în română, folosește
[Required(ErrorMessage = "...")]. - Ține DTO-urile de intrare separate de entitățile din baza de date.
Întrebări frecvente
De ce câmpul e obligatoriu, deși nu are [Required]?
Pentru că e de tip referință non-nullable, iar proiectul are nullable reference types activate. MVC tratează astfel de proprietăți ca [Required] (opțiunea SuppressImplicitRequiredAttributeForNonNullableReferenceTypes controlează comportamentul).
Și Minimal APIs se comportă la fel?
Minimal APIs nu validează DataAnnotations automat în .NET 8, dar parametrii non-nullable sunt obligatorii la binding: lipsa lor dă 400 cu Required parameter ... was not provided.
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. "errors":{"X-Versiune":["The versiune field is required."]} Acțiunea citește un antet cu [FromHeader(Name = "X-Versiune")] string versiune, iar cererea nu l-a trimis. Parametrul non-nullable e obligatoriu, deci [ApiController] răspunde 400. Trimite antetul sau, dacă e opțional, declară parametrul string? și tratează lipsa lui. The comanda field is required. Cheia erorii e numele parametrului acțiunii (comanda), nu al unei proprietăți: tot corpul nu a putut fi transformat în obiect, deci parametrul a rămas null. Caută lângă ea a doua eroare (cu $) care spune de ce: JSON invalid, listă în loc de obiect, tip greșit. Î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.
