System.Threading.Channels.ChannelClosedException: The channel has been closed.
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
WriteAsyncnou 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
while (true)
{
var comanda = await canal.Reader.ReadAsync();
Proceseaza(comanda);
}await foreach (var comanda in canal.Reader.ReadAllAsync())
Proceseaza(comanda);ReadAllAsync se termină normal când canalul e închis și gol.
2Scriere după Complete
canal.Writer.Complete();
await canal.Writer.WriteAsync(ultima);await canal.Writer.WriteAsync(ultima);
canal.Writer.Complete();Complete() e ultimul pas al producătorului.
3Mai mulți producători, închidere prea devreme
var p1 = Produ("A");
var p2 = Produ("B");
await p1;
canal.Writer.Complete();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ă 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.
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");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.
Reparația
using System.Threading.Channels;
var canal = Channel.CreateUnbounded<int>();
for (int i = 1; i <= 3; i++)
await canal.Writer.WriteAsync(i);
canal.Writer.Complete();
await foreach (int comanda in canal.Reader.ReadAllAsync())
{
Console.WriteLine($"Procesez comanda {comanda}");
}
Console.WriteLine("Toate comenzile au fost procesate");De ce merge
Bucla while (true) cu ReadAsync() citea și după ce canalul fusese închis și golit, de aceea apărea excepția. await foreach peste ReadAllAsync() primește toate cele trei comenzi și se termină normal când producătorul a apelat Complete(), iar programul ajunge la mesajul final.
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 întoarcefalseî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
System.ObjectDisposedException: Cannot access a disposed object. Ai folosit un obiect după ce a fost eliberat cu `Dispose()` sau la ieșirea dintr-un bloc `using` (un stream, un `StreamWriter`, un `HttpClient`, un `CancellationTokenSource`). Mută tot codul care folosește obiectul în interiorul blocului `using` sau creează un obiect nou. System.Threading.Tasks.TaskCanceledException: A task was canceled. O operație asincronă a fost anulată printr-un `CancellationToken` (de utilizator, de un timeout cu `CancelAfter` sau de `HttpClient.Timeout`) și nu ai tratat anularea. Prinde `OperationCanceledException` acolo unde anularea e un caz normal sau mărește timeout-ul dacă operația chiar are nevoie de mai mult timp. System.InvalidOperationException: Stack empty. Ai apelat `Pop()` sau `Peek()` pe un `Stack<T>` gol. Verifică întâi dacă are elemente (`if (stiva.Count > 0)`) sau folosește `TryPop(out var x)` / `TryPeek(out var x)`, care întorc `false` în loc să arunce excepție. La `Queue<T>`, mesajul echivalent este „Queue empty.”. Î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.
