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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
AddOptions<T>().Validate(predicat) adaugă o regulă proprie pentru setări. Dacă predicatul întoarce false, OptionsValidationException e aruncată. Când regula nu are mesaj (al doilea argument), .NET folosește textul implicit A validation error has occurred., care nu spune nimic despre ce s-a întâmplat.
Cu ValidateOnStart(), eroarea apare la pornire; altfel, la prima citire a lui IOptions<T>.Value, ca 500. Dacă ai mai multe reguli fără mesaj, nu vei ști care a picat.
Rezolvarea are două părți: valoarea greșită din configurare (de obicei 0 sau gol, pentru că cheia lipsește sau e scrisă greșit) și mesajul de eroare, ca data viitoare să știi imediat ce să cauți.
De ce apare: cauzele frecvente
1Regulă fără mesaj și valoare lipsă
builder.Services.AddOptions<SetariCos>().BindConfiguration("Cos")
.Validate(s => s.MaxProduse > 0)
.ValidateOnStart();
// appsettings.json: { "Cos": { "MaxProduse": 0 } }builder.Services.AddOptions<SetariCos>().BindConfiguration("Cos")
.Validate(s => s.MaxProduse > 0, "Cos:MaxProduse trebuie să fie mai mare decât 0")
.ValidateOnStart();
// appsettings.json: { "Cos": { "MaxProduse": 20 } }Cu mesaj, excepția spune exact regula încălcată; cu o valoare corectă, validarea trece.
2Proprietatea și cheia au nume diferite
// appsettings.json: { "Cos": { "MaxProduse": 20 } }
public class SetariCos { public int MaxProdus { get; set; } }public class SetariCos { public int MaxProduse { get; set; } }Legarea ignoră cheile care nu corespund unei proprietăți. MaxProdus rămâne 0, iar regula pică.
Repară eroarea, direct în pagină
Aplicația nu pornește cu OptionsValidationException: A validation error has occurred. În appsettings.json cheia este Cos:MaxProduse, dar proprietatea clasei de setări se numește MaxProdus, deci rămâne 0. Redenumește proprietatea ca să corespundă cheii și dă regulii mesajul Cos:MaxProduse trebuie să fie pozitiv, ca GET /cos/limita să răspundă 20.
using Microsoft.Extensions.Options;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddOptions<SetariCos>()
.BindConfiguration("Cos")
.Validate(s => s.MaxProdus > 0) // TODO: adaugă un mesaj
.ValidateOnStart();
var app = builder.Build();
app.MapGet("/cos/limita", (IOptions<SetariCos> o) => o.Value.MaxProdus);
app.Run();
public class SetariCos
{
// TODO: cheia din appsettings.json este MaxProduse
public int MaxProdus { get; set; }
}GET /cos/limita → 200 OK 20
Indiciu
Legarea potrivește cheile cu proprietățile după nume; mesajul este al doilea argument al lui Validate.
Reparația
using Microsoft.Extensions.Options;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddOptions<SetariCos>()
.BindConfiguration("Cos")
.Validate(s => s.MaxProduse > 0, "Cos:MaxProduse trebuie să fie pozitiv")
.ValidateOnStart();
var app = builder.Build();
app.MapGet("/cos/limita", (IOptions<SetariCos> o) => o.Value.MaxProduse);
app.Run();
public class SetariCos
{
public int MaxProduse { get; set; }
}De ce merge
Legarea caută pentru fiecare proprietate o cheie cu același nume, deci MaxProdus nu primea nimic și rămânea 0, iar regula pica. După redenumire, valoarea 20 ajunge în proprietate și validarea trece. Mesajul adăugat regulii face ca, data viitoare, excepția să spună exact ce valoare lipsește, în locul textului generic.
Alte forme ale mesajului
Microsoft.Extensions.Options.OptionsValidationException: Cos:MaxProduse trebuie să fie mai mare decât 0
Cum o eviți pe viitor
- Dă întotdeauna un mesaj fiecărei reguli
.Validate(...), cu numele cheii din configurare. - Pentru reguli multe, scrie o clasă
IValidateOptions<T>care întoarce toate erorile odată. - Pune
ValidateOnStart()ca greșeala să oprească deploy-ul, nu o cerere. - Verifică numele cheilor (legarea nu raportează chei necunoscute).
Întrebări frecvente
De unde știu ce regulă a picat?
Din mesaj, dacă i-ai dat unul. Cu textul implicit nu ai cum: adaugă mesaje și rulează din nou.
Merge și cu DataAnnotations în același timp?
Da. ValidateDataAnnotations() și Validate(...) se pot combina; toate erorile apar în aceeași excepție.
Erori înrudite
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. 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.
