System.InvalidOperationException: Cannot consume scoped service 'Microsoft.Extensions.Options.IOptionsSnapshot`1[SetariLivrare]' from singleton 'CalculatorLivrare'.
IOptionsSnapshot<T> este scoped (recalculat la fiecare cerere), deci nu poate fi injectat într-un singleton. Într-un singleton folosește IOptionsMonitor<T> (cu CurrentValue) dacă vrei valorile actualizate, sau IOptions<T> dacă ajung cele de la pornire.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Există trei feluri de a injecta setări:
IOptions<T>: singleton, valorile citite o singură dată;IOptionsSnapshot<T>: scoped, recitește valorile la începutul fiecărei cereri (util când fișierul se schimbă cureloadOnChange);IOptionsMonitor<T>: singleton, cuCurrentValuemereu actual și evenimentulOnChange.
Pentru că IOptionsSnapshot<T> e scoped, regula duratelor de viață se aplică și lui: un singleton nu îl poate primi. În Development primești la pornire Cannot consume scoped service 'Microsoft.Extensions.Options.IOptionsSnapshot1[SetariLivrare]' from singleton 'CalculatorLivrare' (1[...] e felul în care .NET scrie un tip generic).
Alegerea corectă depinde de serviciu: singletonul care trebuie să vadă modificările folosește IOptionsMonitor<T>.
De ce apare: cauzele frecvente
1Singleton cu IOptionsSnapshot
builder.Services.AddSingleton<CalculatorLivrare>();
class CalculatorLivrare(IOptionsSnapshot<SetariLivrare> s)
{
public decimal Taxa() => s.Value.Taxa;
}builder.Services.AddSingleton<CalculatorLivrare>();
class CalculatorLivrare(IOptionsMonitor<SetariLivrare> s)
{
public decimal Taxa() => s.CurrentValue.Taxa;
}IOptionsMonitor<T> e singleton și citește valoarea curentă la fiecare apel, deci singletonul vede și modificările.
2Serviciul poate fi scoped
builder.Services.AddSingleton<CalculatorLivrare>();builder.Services.AddScoped<CalculatorLivrare>();Dacă serviciul nu are stare de păstrat, îl poți coborî la scoped și păstra IOptionsSnapshot<T>.
Repară eroarea, direct în pagină
Aplicația nu pornește: singletonul CalculatorLivrare primește IOptionsSnapshot<SetariLivrare>. Păstrează-l singleton, dar injectează IOptionsMonitor<SetariLivrare> și citește CurrentValue, ca GET /livrare?total=150 să răspundă Taxa de livrare: 0 lei și GET /livrare?total=80 să răspundă Taxa de livrare: 15 lei.
using Microsoft.Extensions.Options;
var builder = WebApplication.CreateBuilder(args);
builder.Services.Configure<SetariLivrare>(builder.Configuration.GetSection("Livrare"));
builder.Services.AddSingleton<CalculatorLivrare>();
var app = builder.Build();
app.MapGet("/livrare", (decimal total, CalculatorLivrare calc) => $"Taxa de livrare: {calc.Taxa(total)} lei");
app.Run();
public class SetariLivrare
{
public decimal Taxa { get; set; }
public decimal PragGratuit { get; set; }
}
// TODO: singletonul nu poate primi IOptionsSnapshot
public class CalculatorLivrare(IOptionsSnapshot<SetariLivrare> setari)
{
public decimal Taxa(decimal total) => total >= setari.Value.PragGratuit ? 0 : setari.Value.Taxa;
}GET /livrare?total=150 → 200 OK Taxa de livrare: 0 lei GET /livrare?total=80 → 200 OK Taxa de livrare: 15 lei
Indiciu
IOptionsMonitor<T> are proprietatea CurrentValue, nu Value.
Reparația
using Microsoft.Extensions.Options;
var builder = WebApplication.CreateBuilder(args);
builder.Services.Configure<SetariLivrare>(builder.Configuration.GetSection("Livrare"));
builder.Services.AddSingleton<CalculatorLivrare>();
var app = builder.Build();
app.MapGet("/livrare", (decimal total, CalculatorLivrare calc) => $"Taxa de livrare: {calc.Taxa(total)} lei");
app.Run();
public class SetariLivrare
{
public decimal Taxa { get; set; }
public decimal PragGratuit { get; set; }
}
public class CalculatorLivrare(IOptionsMonitor<SetariLivrare> setari)
{
public decimal Taxa(decimal total)
{
var s = setari.CurrentValue;
return total >= s.PragGratuit ? 0 : s.Taxa;
}
}De ce merge
IOptionsSnapshot<T> trăiește o cerere, deci nu încape într-un singleton. IOptionsMonitor<T> este el însuși singleton și dă la fiecare apel valoarea curentă a setărilor, inclusiv după reîncărcarea fișierului. Calculatorul rămâne singleton, iar validarea scopurilor trece. Valoarea se citește la fiecare apel, nu se păstrează într-un câmp.
Alte forme ale mesajului
Cannot consume scoped service 'Microsoft.Extensions.Options.IOptionsSnapshot`1[SetariEmail]' from singleton 'Microsoft.Extensions.Hosting.IHostedService'.
Cum o eviți pe viitor
- În singletoni și
BackgroundService:IOptions<T>sauIOptionsMonitor<T>. - În servicii scoped și handler-e: oricare dintre ele;
IOptionsSnapshot<T>dacă vrei valori consistente pe toată cererea. - Nu păstra
CurrentValueîntr-un câmp: citește-l la fiecare folosire. - Rulează în Development: validarea scopurilor semnalează la pornire orice
IOptionsSnapshotajuns într-un singleton sau într-un serviciu găzduit.
Întrebări frecvente
Care e diferența practică dintre Snapshot și Monitor?
Snapshot îți dă aceeași valoare pe toată durata unei cereri, chiar dacă fișierul se schimbă la mijloc. Monitor îți dă mereu ultima valoare și poate anunța schimbările prin OnChange.
IOptions<T> vede modificările din fișier?
Nu. Valoarea e calculată la prima folosire și rămâne aceeași până la repornire.
Erori înrudite
System.InvalidOperationException: Cannot consume scoped service 'CosCumparaturi' from singleton 'ServiciuRecomandari'. Un serviciu singleton (o singură instanță pentru toată aplicația) primește în constructor un serviciu scoped (unul pe cerere). ASP.NET Core oprește asta la pornire. Fă serviciul scoped, sau creează un scope cu IServiceScopeFactory doar acolo unde ai nevoie de serviciul scoped. 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. Î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.
