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

System.InvalidOperationException: Cannot consume scoped service 'Microsoft.Extensions.Options.IOptionsSnapshot`1[SetariLivrare]' from singleton 'CalculatorLivrare'.

Pe scurt

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ă cu reloadOnChange);
  • IOptionsMonitor<T>: singleton, cu CurrentValue mereu actual și evenimentul OnChange.

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

Greșit
C#
builder.Services.AddSingleton<CalculatorLivrare>();

class CalculatorLivrare(IOptionsSnapshot<SetariLivrare> s)
{
    public decimal Taxa() => s.Value.Taxa;
}
Corect
C#
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

Greșit
C#
builder.Services.AddSingleton<CalculatorLivrare>();
Corect
C#
builder.Services.AddScoped<CalculatorLivrare>();

Dacă serviciul nu are stare de păstrat, îl poți coborî la scoped și păstra IOptionsSnapshot<T>.

Repară tu

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.

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

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> sau IOptionsMonitor<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 IOptionsSnapshot ajuns î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

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