...
Eroare C# · Async, task-uri și anulare

System.InvalidOperationException: An attempt was made to transition a task to a final state when it had already completed.

Pe scurt

Ai apelat `SetResult`, `SetException` sau `SetCanceled` de două ori pe același `TaskCompletionSource`. Un task se poate termina o singură dată. Folosește `TrySetResult` (care întoarce `false` dacă task-ul era deja terminat) sau creează un `TaskCompletionSource` nou pentru fiecare operație.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

TaskCompletionSource<T> îți dă un Task<T> pe care îl termini tu, manual: cu SetResult(valoare), SetException(ex) sau SetCanceled(). E folosit pentru a transforma callback-uri și evenimente în await. Un task are însă o singură stare finală: odată terminat, nu mai poate fi schimbat. Al doilea apel Set... aruncă System.InvalidOperationException: An attempt was made to transition a task to a final state when it had already completed..

Situații tipice:

  • un eveniment se declanșează de mai multe ori (de exemplu un mesaj primit de două ori), iar handlerul face SetResult de fiecare dată;
  • ai și un timeout, și un răspuns, iar ambele încearcă să termine task-ul;
  • reutilizezi același TaskCompletionSource pentru mai multe cereri.

Reparații: TrySetResult / TrySetException / TrySetCanceled, care nu aruncă, ci întorc false; dezabonarea de la eveniment după primul apel; un TaskCompletionSource nou pentru fiecare cerere. Creează-l cu TaskCreationOptions.RunContinuationsAsynchronously, ca codul de după await să nu ruleze în interiorul lui SetResult.

De ce apare: cauzele frecvente

1Evenimentul se declanșează de două ori

Greșit
C#
senzor.Citire += v => tcs.SetResult(v);
Corect
C#
senzor.Citire += v => tcs.TrySetResult(v);

TrySetResult acceptă doar primul rezultat și ignoră restul.

2Timeout și răspuns care concurează

Greșit
C#
_ = Task.Delay(5000).ContinueWith(_ => tcs.SetCanceled());
client.Raspuns += r => tcs.SetResult(r);
Corect
C#
_ = Task.Delay(5000).ContinueWith(_ => tcs.TrySetCanceled());
client.Raspuns += r => tcs.TrySetResult(r);

Cine termină primul câștigă, iar celălalt apel nu mai aruncă excepție.

3Același TaskCompletionSource pentru mai multe cereri

Greșit
C#
private readonly TaskCompletionSource<string> tcs = new();
Corect
C#
private TaskCompletionSource<string> tcs;
public Task<string> CereAsync()
{
    tcs = new(TaskCreationOptions.RunContinuationsAsynchronously);
    return tcs.Task;
}

Fiecare cerere primește propriul task.

Repară tu

Repară eroarea, direct în pagină

Programul așteaptă prima citire a unui senzor printr-un TaskCompletionSource, dar senzorul trimite două valori, iar programul se oprește cu System.InvalidOperationException: An attempt was made to transition a task to a final state when it had already completed. Repară handlerul ca programul să afișeze Prima citire: 21.5.

Codul care dă eroarea
C#
var tcs = new TaskCompletionSource<double>();
var senzor = new Senzor();
senzor.Citire += v => tcs.SetResult(v);
senzor.Trimite(21.5);
senzor.Trimite(22.0);
Console.WriteLine($"Prima citire: {await tcs.Task}");

class Senzor
{
    public event Action<double> Citire;
    public void Trimite(double v) => Citire?.Invoke(v);
}
După reparație, programul afișează
Prima citire: 21.5
Indiciu

Există o variantă a lui SetResult care nu aruncă excepție dacă task-ul era deja terminat.

Alte forme ale mesajului

  • System.InvalidOperationException: An attempt was made to transition a task to a final state when it had already completed. at System.Threading.Tasks.TaskCompletionSource`1.SetResult(TResult result)

Cum o eviți pe viitor

  • Când un TaskCompletionSource poate fi terminat din mai multe locuri, folosește doar metodele TrySet....
  • Creează un TaskCompletionSource nou pentru fiecare operație și dezabonează-te de la evenimente când ai terminat.
  • Folosește TaskCreationOptions.RunContinuationsAsynchronously la creare, ca un SetResult să nu ruleze sincron tot codul de după await.
  • Dacă sursa e un eveniment, dezabonează handlerul după primul rezultat.

Întrebări frecvente

Pierd ceva dacă folosesc TrySetResult?

Nu, primești în plus informația dacă ai fost primul (true) sau task-ul era deja terminat (false). Poți folosi valoarea întoarsă pentru log, dacă vrei să știi când apar rezultate duplicate.

Pot reseta un task terminat?

Nu. Un Task terminat rămâne așa. Pentru o nouă operație creezi un TaskCompletionSource nou.

Erori înrudite

← Toate erorile C#

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ță C# de la zero, cu exerciții la fiecare lecție

Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.