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

System.Threading.Channels.ChannelClosedException: The channel has been closed.

Pe scurt

Ai scris într-un `Channel` după `Writer.Complete()` sau ai citit cu `ReadAsync()` după ce canalul a fost închis și golit. Consumatorul trebuie să citească cu `await foreach (var x in reader.ReadAllAsync())`, care se oprește singur la închidere, iar producătorul să nu mai scrie după `Complete()` (sau să folosească `TryWrite`).

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

Ce înseamnă

System.Threading.Channels e o coadă asincronă între producători și consumatori. Producătorul scrie cu Writer.WriteAsync, iar când a terminat apelează Writer.Complete(). Consumatorul citește cu Reader.ReadAsync().

După Complete(), canalul e marcat închis:

  • orice WriteAsync nou aruncă ChannelClosedException: The channel has been closed.;
  • ReadAsync() mai întoarce elementele rămase, apoi, când coada e goală, aruncă aceeași excepție.

Cel mai des greșeala e o buclă while (true) { var x = await reader.ReadAsync(); ... }, care funcționează până la final și se oprește cu excepție la închiderea canalului. Varianta corectă e await foreach (var x in reader.ReadAllAsync()), care se termină normal când canalul e închis și gol. Alternativ: while (await reader.WaitToReadAsync()) while (reader.TryRead(out var x)) ....

Dacă excepția apare la scriere, ai mai mulți producători și unul a închis canalul prea devreme: închide-l doar după ce toți au terminat (de exemplu după await Task.WhenAll(producatori)).

De ce apare: cauzele frecvente

1Consumator cu while(true) și ReadAsync

Greșit
C#
while (true)
{
    var comanda = await canal.Reader.ReadAsync();
    Proceseaza(comanda);
}
Corect
C#
await foreach (var comanda in canal.Reader.ReadAllAsync())
    Proceseaza(comanda);

ReadAllAsync se termină normal când canalul e închis și gol.

2Scriere după Complete

Greșit
C#
canal.Writer.Complete();
await canal.Writer.WriteAsync(ultima);
Corect
C#
await canal.Writer.WriteAsync(ultima);
canal.Writer.Complete();

Complete() e ultimul pas al producătorului.

3Mai mulți producători, închidere prea devreme

Greșit
C#
var p1 = Produ("A");
var p2 = Produ("B");
await p1;
canal.Writer.Complete();
Corect
C#
var p1 = Produ("A");
var p2 = Produ("B");
await Task.WhenAll(p1, p2);
canal.Writer.Complete();

Canalul se închide abia după ce toți producătorii au terminat.

Repară tu

Repară eroarea, direct în pagină

Programul trimite comenzi printr-un Channel de la producător la consumator, dar după ultima comandă se oprește cu System.Threading.Channels.ChannelClosedException: The channel has been closed. Repară consumatorul ca programul să afișeze Procesez comanda 1, Procesez comanda 2, Procesez comanda 3 și Toate comenzile au fost procesate.

Codul care dă eroarea
C#
using System.Threading.Channels;

var canal = Channel.CreateUnbounded<int>();
for (int i = 1; i <= 3; i++)
    await canal.Writer.WriteAsync(i);
canal.Writer.Complete();

while (true)
{
    int comanda = await canal.Reader.ReadAsync();
    Console.WriteLine($"Procesez comanda {comanda}");
}
Console.WriteLine("Toate comenzile au fost procesate");
După reparație, programul afișează
Procesez comanda 1
Procesez comanda 2
Procesez comanda 3
Toate comenzile au fost procesate
Indiciu

Există o metodă a cititorului care se oprește singură când canalul e închis.

Alte forme ale mesajului

  • System.Threading.Channels.ChannelClosedException: The channel has been closed. at System.Threading.Channels.ChannelReader`1.ReadAsync(CancellationToken cancellationToken)

Cum o eviți pe viitor

  • Consumă canalele cu await foreach (... in reader.ReadAllAsync()).
  • Apelează Writer.Complete() o singură dată, după ce toți producătorii au terminat.
  • Dacă un producător poate întârzia după închidere, folosește TryWrite, care întoarce false în loc să arunce excepție.
  • Pentru erori, închide canalul cu Complete(exceptie), ca să afle și consumatorul.

Întrebări frecvente

Cum transmit o eroare de la producător la consumator?

Apelează Writer.Complete(exceptie). Consumatorul care citește cu ReadAllAsync va primi acea excepție când ajunge la finalul canalului.

Care e diferența față de BlockingCollection?

BlockingCollection blochează firul de execuție la citire, iar Channel e gândit pentru async/await și nu blochează. În cod asincron modern se folosește Channel.

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.