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

Microsoft.Extensions.Options.OptionsValidationException: DataAnnotation validation failed for 'SetariEmail' members: 'Expeditor' with the error: 'The Expeditor field is required.'.

Pe scurt

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

Greșit
C#
{ "Email": { "Server": "smtp.exemplu.ro" } }
Corect
C#
{ "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

Greșit
C#
builder.Services.AddOptions<SetariEmail>().BindConfiguration("Mail").ValidateDataAnnotations();
// appsettings.json are secțiunea "Email"
Corect
C#
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

Greșit
C#
{ "Email": { "Expeditor": "a@b.ro", "Port": 70000 } }
// [Range(1, 65535)] public int Port
Corect
C#
{ "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ă tu

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.

Codul care dă eroarea
C#
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; } = "";
}
După reparație, programul afișează
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.

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

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