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

The comanda field is required.

Pe scurt

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.

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

Ce înseamnă

Când mesajul este The comanda field is required. și comanda este chiar numele parametrului din acțiune (Plaseaza(ComandaNoua comanda)), problema nu e un câmp lipsă, ci întregul corp. Deserializarea a eșuat, parametrul a rămas null, iar validarea implicită (parametrul e non-nullable) îl raportează ca lipsă.

Aproape întotdeauna apare împreună cu o eroare cu cheia $ sau $.ceva, care spune cauza reală: The JSON value could not be converted to ComandaNoua. Path: $ (clientul a trimis un tablou în loc de obiect), 'x' is an invalid start of a value (JSON stricat), sau o conversie de tip.

Reparația depinde de cauză: dacă clientul trimite corect o listă, acțiunea trebuie să primească List<ComandaNoua>; dacă JSON-ul e stricat, se repară clientul.

De ce apare: cauzele frecvente

1Clientul trimite o listă, acțiunea așteaptă un obiect

Greșit
C#
[HttpPost]
public IActionResult Plaseaza(ComandaNoua comanda) => ...
// POST [{"produs": "Mouse", "cantitate": 2}]
Corect
C#
[HttpPost]
public IActionResult Plaseaza(List<ComandaNoua> comenzi) => ...

Forma JSON-ului (tablou sau obiect) trebuie să corespundă tipului parametrului.

2JSON stricat

Greșit
C#
{"produs": "Mouse", "cantitate": 2,}
Corect
C#
{"produs": "Mouse", "cantitate": 2}

Virgula finală nu e permisă implicit de System.Text.Json; eroarea $ arată poziția.

Repară tu

Repară eroarea, direct în pagină

Aplicația de casă trimite comenzile în lot, ca tablou JSON, iar POST /api/comenzi răspunde 400 cu The comanda field is required. (și o eroare $). Schimbă acțiunea ca să primească o listă de comenzi și să răspundă 2 comenzi plasate, 3 produse.

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 class ComandaNoua
{
    public string Produs { get; set; } = "";
    public int Cantitate { get; set; }
}

[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
    // TODO: clientul trimite un tablou de comenzi
    [HttpPost]
    public IActionResult Plaseaza(ComandaNoua comanda) => Ok($"1 comenzi plasate, {comanda.Cantitate} produse");
}
După reparație, programul afișează
POST /api/comenzi → 200 OK
2 comenzi plasate, 3 produse
Indiciu

Tipul parametrului trebuie să aibă aceeași formă ca JSON-ul: un tablou.

Alte forme ale mesajului

  • The produs field is required.
  • "errors":{"comanda":["The comanda field is required."],"$":["The JSON value could not be converted to ComandaNoua. Path: $ | LineNumber: 0 | BytePositionInLine: 1."]}

Cum o eviți pe viitor

  • Citește toate erorile din errors; cea cu $ e cauza.
  • Decide clar în contract dacă un endpoint primește un obiect sau o listă (de exemplu POST /comenzi vs POST /comenzi/lot).
  • Validează JSON-ul în client înainte de trimitere.

Întrebări frecvente

Cum deosebesc un câmp lipsă de un corp invalid?

Cheia erorii: numele unei proprietăți (Produs) înseamnă câmp lipsă; numele parametrului acțiunii (comanda) înseamnă că tot obiectul a rămas null.

Pot face parametrul opțional ca să scap de eroare?

Ai ascunde problema: acțiunea ar rula cu null. Repară forma datelor sau tipul parametrului.

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.