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

The Descriere field is required.

Pe scurt

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 trimite null sau 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

Greșit
C#
public class AnuntNou
{
    public string Titlu { get; set; } = "";
    public string Descriere { get; set; } = "";
}
// POST {"titlu": "Bicicletă", "descriere": null}
Corect
C#
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

Greșit
C#
// POST {"descriere": "Ca nouă"}  (fără titlu)
Corect
C#
// 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

Greșit
C#
[HttpGet]
public IActionResult Cauta([FromQuery] string termen) => ...
Corect
C#
[HttpGet]
public IActionResult Cauta([FromQuery] string? termen) => ...

Parametrii urmează aceeași regulă: fără ?, termen devine obligatoriu.

Repară tu

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.

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 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));
}
După reparație, programul afișează
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.

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 (string sau string?).
  • 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

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