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.
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
[HttpPost]
public IActionResult Plaseaza(ComandaNoua comanda) => ...
// POST [{"produs": "Mouse", "cantitate": 2}][HttpPost]
public IActionResult Plaseaza(List<ComandaNoua> comenzi) => ...Forma JSON-ului (tablou sau obiect) trebuie să corespundă tipului parametrului.
2JSON stricat
{"produs": "Mouse", "cantitate": 2,}{"produs": "Mouse", "cantitate": 2}Virgula finală nu e permisă implicit de System.Text.Json; eroarea $ arată poziția.
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.
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");
}POST /api/comenzi → 200 OK 2 comenzi plasate, 3 produse
Indiciu
Tipul parametrului trebuie să aibă aceeași formă ca JSON-ul: un tablou.
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 class ComandaNoua
{
public string Produs { get; set; } = "";
public int Cantitate { get; set; }
}
[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
[HttpPost]
public IActionResult Plaseaza(List<ComandaNoua> comenzi) =>
Ok($"{comenzi.Count} comenzi plasate, {comenzi.Sum(c => c.Cantitate)} produse");
}De ce merge
Corpul era un tablou JSON, iar acțiunea aștepta un singur obiect, deci deserializarea a eșuat și parametrul a rămas null. Cu List<ComandaNoua> comenzi, forma tipului corespunde datelor, iar lista se completează corect. Totalul de produse se calculează cu Sum pe cantități.
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 /comenzivsPOST /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
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. A non-empty request body is required. Acțiunea are un parametru citit din corp (un obiect complex), dar cererea a venit fără corp. [ApiController] răspunde 400 cu eroarea sub cheia goală "". Trimite corpul JSON sau, dacă acțiunea nu are nevoie de el, scoate parametrul ori ia valoarea din rută sau query. 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ă. Î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.
