...
Eroare ASP.NET Core · Configurare, Options și logging

Microsoft.Extensions.Options.OptionsValidationException: A validation error has occurred.

Pe scurt

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ă

Greșit
C#
builder.Services.AddOptions<SetariCos>().BindConfiguration("Cos")
    .Validate(s => s.MaxProduse > 0)
    .ValidateOnStart();
// appsettings.json: { "Cos": { "MaxProduse": 0 } }
Corect
C#
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

Greșit
C#
// appsettings.json: { "Cos": { "MaxProduse": 20 } }
public class SetariCos { public int MaxProdus { get; set; } }
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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; }
}
După reparație, programul afișează
GET /cos/limita → 200 OK
20
Indiciu

Legarea potrivește cheile cu proprietățile după nume; mesajul este al doilea argument al lui Validate.

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

← 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.