Microsoft.Extensions.Options.OptionsValidationException: DataAnnotation validation failed for 'SetariEmail' members: 'Expeditor' with the error: 'The Expeditor field is required.'.
Setările legate cu ValidateDataAnnotations nu respectă atributele clasei: o valoare [Required] lipsește sau un [Range] e depășit în appsettings.json ori în variabilele de mediu. Mesajul spune clasa, proprietatea și regula. Completează valoarea în configurare, nu șterge validarea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Options pattern poate valida setările cu aceleași atribute ca modelele: [Required], [Range], [EmailAddress], [Url]. Când ai scris AddOptions<SetariEmail>().BindConfiguration("Email").ValidateDataAnnotations(), valorile citite din configurare sunt verificate, iar orice abatere aruncă OptionsValidationException.
Mesajul se citește așa: for 'SetariEmail' este clasa de setări, members: 'Expeditor' proprietatea, iar with the error: '...' regula încălcată (mesajul standard al atributului). Dacă sunt mai multe probleme, apar toate, separate prin virgulă.
Momentul în care apare depinde de ValidateOnStart(): cu el, aplicația nu pornește deloc (ce îți dorești pentru setări obligatorii); fără el, eroarea apare la prima citire a lui .Value, adică la prima cerere care folosește setările, ca 500.
De ce apare: cauzele frecvente
1Valoarea lipsește din configurare
{ "Email": { "Server": "smtp.exemplu.ro" } }{ "Email": { "Server": "smtp.exemplu.ro", "Expeditor": "comenzi@exemplu.ro" } }Expeditor are [Required]. Fără cheia Email:Expeditor în configurare, proprietatea rămâne goală și validarea pică.
2Numele secțiunii nu corespunde
builder.Services.AddOptions<SetariEmail>().BindConfiguration("Mail").ValidateDataAnnotations();
// appsettings.json are secțiunea "Email"builder.Services.AddOptions<SetariEmail>().BindConfiguration("Email").ValidateDataAnnotations();Cu o secțiune inexistentă, nimic nu se leagă și toate proprietățile obligatorii par lipsă.
3Valoare în afara intervalului
{ "Email": { "Expeditor": "a@b.ro", "Port": 70000 } }
// [Range(1, 65535)] public int Port{ "Email": { "Expeditor": "a@b.ro", "Port": 587 } }[Range] dă mesajul The field Port must be between 1 and 65535. în aceeași excepție.
Repară eroarea, direct în pagină
Aplicația nu pornește: secțiunea Email din appsettings.json nu are Expeditor, iar validarea cere câmpul. Fișierele proiectului nu se pot edita aici, așa că adaugă valoarea comenzi@magazin.ro din cod, cu AddInMemoryCollection, ca GET /email să răspundă Trimit de la comenzi@magazin.ro prin smtp.magazin.ro.
using System.ComponentModel.DataAnnotations;
using Microsoft.Extensions.Options;
var builder = WebApplication.CreateBuilder(args);
// TODO: adaugă cheia Email:Expeditor în configurare
builder.Services.AddOptions<SetariEmail>()
.BindConfiguration("Email")
.ValidateDataAnnotations()
.ValidateOnStart();
var app = builder.Build();
app.MapGet("/email", (IOptions<SetariEmail> o) => $"Trimit de la {o.Value.Expeditor} prin {o.Value.Server}");
app.Run();
public class SetariEmail
{
[Required] public string Server { get; set; } = "";
[Required] public string Expeditor { get; set; } = "";
}GET /email → 200 OK Trimit de la comenzi@magazin.ro prin smtp.magazin.ro
Indiciu
builder.Configuration.AddInMemoryCollection(new Dictionary<string, string?> { ["Email:Expeditor"] = "..." }); înainte de înregistrarea opțiunilor.
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.Extensions.Options;
var builder = WebApplication.CreateBuilder(args);
builder.Configuration.AddInMemoryCollection(new Dictionary<string, string?>
{
["Email:Expeditor"] = "comenzi@magazin.ro"
});
builder.Services.AddOptions<SetariEmail>()
.BindConfiguration("Email")
.ValidateDataAnnotations()
.ValidateOnStart();
var app = builder.Build();
app.MapGet("/email", (IOptions<SetariEmail> o) => $"Trimit de la {o.Value.Expeditor} prin {o.Value.Server}");
app.Run();
public class SetariEmail
{
[Required] public string Server { get; set; } = "";
[Required] public string Expeditor { get; set; } = "";
}De ce merge
Validarea a funcționat corect: setarea obligatorie lipsea. Adăugând cheia Email:Expeditor într-o sursă de configurare (aici în memorie; în realitate în appsettings.json sau ca variabilă de mediu Email__Expeditor), legarea completează proprietatea, iar ValidateOnStart trece. Validarea rămâne pe loc, ca să prindă aceeași greșeală la următorul deploy.
Alte forme ale mesajului
Microsoft.Extensions.Options.OptionsValidationException: DataAnnotation validation failed for 'SetariEmail' members: 'Port' with the error: 'The field Port must be between 1 and 65535.'.
Cum o eviți pe viitor
- Pune
ValidateOnStart()la setările obligatorii: afli de problemă la deploy, nu la prima cerere. - Ține numele secțiunii într-o constantă (
SetariEmail.Sectiune). - Documentează cheile obligatorii în
appsettings.json(cu valori de exemplu) sau în README. - În producție, verifică variabilele de mediu:
Email__Expeditor(cu două liniuțe jos).
Întrebări frecvente
De ce am nevoie de ValidateOnStart?
Fără el, validarea rulează leneș, la prima citire a lui .Value. Aplicația pornește aparent bine și pică abia la prima cerere care trimite un email.
Pot valida reguli între proprietăți?
Da: cu .Validate(s => conditie, "mesaj") sau cu o clasă IValidateOptions<T>. Mesajul tău apare atunci în excepție.
Erori înrudite
Microsoft.Extensions.Options.OptionsValidationException: A validation error has occurred. O regulă scrisă cu .Validate(s => ...) pentru setări a întors false, iar pentru că nu i-ai dat un mesaj, primești textul generic. Repară valoarea din configurare și dă fiecărei reguli un mesaj clar: .Validate(s => s.Max > 0, "Max trebuie să fie pozitiv"). System.InvalidOperationException: Section 'Plati' not found in configuration. GetRequiredSection("Plati") nu a găsit secțiunea în nicio sursă de configurare: lipsește din appsettings.json, e scrisă altfel sau e doar în appsettings.Production.json. Adaugă secțiunea sau corectează numele. System.InvalidOperationException: Failed to convert configuration value 'zece' at 'Cos:MaxProduse' to type 'System.Int32'. O valoare din configurare nu poate fi transformată în tipul cerut: ai cerut int, dar în appsettings.json sau în variabila de mediu e un text ("zece", "20 buc", "1,5"). Corectează valoarea din configurare ca să fie în formatul tipului. Î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.
