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

The field Produse must be a string or array type with a minimum length of '1'.

Pe scurt

Atributul [MinLength(n)] a găsit un text sau o listă cu mai puține elemente decât minimul, de exemplu o comandă cu lista de produse goală. Trimite cel puțin n elemente sau verifică dacă atributul e pus pe proprietatea potrivită.

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

Ce înseamnă

[MinLength] și [MaxLength] funcționează și pentru string-uri, și pentru colecții (tablouri, liste), de aceea mesajul spune „string or array type”. [MinLength(1)] pe o listă înseamnă „cel puțin un element”: o comandă fără produse, un formular fără opțiuni.

O capcană: [Required] pe o listă nu respinge lista goală, ci doar null. Pentru „nu poate fi goală” ai nevoie de [MinLength(1)] (sau de [Length(1, 20)] din .NET 8).

Cealaltă capcană e un copy-paste greșit: [MinLength(8)] ajuns de la Parola pe Nume face ca numele scurte să fie respinse. Mesajul îți spune proprietatea și minimul: verifică dacă sunt cele pe care le aștepți.

De ce apare: cauzele frecvente

1Comandă trimisă fără produse

Greșit
C#
public class ComandaNoua
{
    [MinLength(1)] public List<string> Produse { get; set; } = [];
}
// POST {"produse": []}
Corect
C#
// POST {"produse": ["Mouse"]}

Lista goală e respinsă intenționat: o comandă trebuie să aibă cel puțin un produs.

2Atribut copiat pe proprietatea greșită

Greșit
C#
[MinLength(8)] public string Nume { get; set; } = "";
public string Parola { get; set; } = "";
Corect
C#
public string Nume { get; set; } = "";
[MinLength(8)] public string Parola { get; set; } = "";

Regula de lungime minimă era pentru parolă; pe nume respinge valori corecte.

Repară tu

Repară eroarea, direct în pagină

La înregistrare, numele Ion e respins cu The field Nume must be a string or array type with a minimum length of '8'., iar parola 123 e acceptată. Atributul [MinLength(8)] a ajuns pe proprietatea greșită: mută-l pe Parola, ca prima cerere să fie acceptată, iar a doua (parolă scurtă) respinsă.

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 Inregistrare
{
    // TODO: regula de lungime minimă e pe proprietatea greșită
    [MinLength(8)] public string Nume { get; set; } = "";
    public string Parola { get; set; } = "";
}

[ApiController]
[Route("api/conturi")]
public class ConturiController : ControllerBase
{
    [HttpPost]
    public IActionResult Creeaza(Inregistrare date) => Ok($"Cont creat pentru {date.Nume}");
}
După reparație, programul afișează
POST /api/conturi → 200 OK
Cont creat pentru Ion
POST /api/conturi → 400 Bad Request
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Parola":["The field Parola must be a string or array type with a minimum length of '8'."]}}
Indiciu

Regula de 8 caractere ține de parolă, nu de nume.

Alte forme ale mesajului

  • The field Parola must be a string or array type with a minimum length of '8'.
  • The field Nume must be a string or collection type with a minimum length of '1' and maximum length of '50'.

Cum o eviți pe viitor

  • Pentru liste care nu pot fi goale, folosește [MinLength(1)], nu [Required].
  • Revizuiește atributele când copiezi proprietăți între clase.
  • Scrie un test pentru lista goală și unul pentru lungimea minimă exactă.
  • Pentru mesaje în română, folosește ErrorMessage, cu {0} pentru numele câmpului și {1} pentru lungimea minimă.

Întrebări frecvente

De ce [Required] nu prinde lista goală?

[Required] verifică doar că valoarea nu e null (și, la string-uri, că nu e goală). O listă goală nu e null, deci trece.

Ce e [Length] din .NET 8?

[Length(min, max)] combină minimul și maximul pentru string-uri și colecții într-un singur atribut.

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.