一句话总结
Channel<T> 是用于协程之间消息传递的协程安全队列——它是构建管道、扇出 / 扇入,以及任何无法仅用 Flow 或共享状态表达的协调机制的基础构件。
何时使用本技能
多个生产者协程或多个消费者协程需要在一条值流上协调时。
构建管道:阶段 A 生产;阶段 B 转换;阶段 C 写入。每个阶段都是自己的协程,通过 channel 连接。
扇出(fan-out):一个生产者,多个工作协程(负载分发)。
扇入(fan-in):多个生产者,一个消费者(收集结果)。
当 Flow 过于受限时——Flow 是单收集者、冷的;Channel 允许多个协程竞争元素。
何时不要使用本技能
单生产者、单消费者且无需缓冲时 → 直接使用 Flow(冷)或 suspend fun。
需要与多个订阅者共享可观察状态时 → StateFlow / SharedFlow(参见 kp-flow-cold-vs-hot)。
对流进行纯转换时 → Flow 操作符(参见 kp-flow-operators)。
非协程代码中线程之间的协调 → 使用 java.util.concurrent 队列。
核心内容
发送与接收。channel.send(x) 会挂起,直到有接收者就绪(会合)或直到缓冲容量允许。channel.receive() 会挂起,直到有值可用。两者都可取消。
val ch = Channel<Int>() launch { for (n in 1..5) ch.send(n); ch.close() } launch { for (n in ch) println(n) } // for-loop iterates until close
四种容量模式(最具影响的设计决策):
Channel.RENDEZVOUS(默认,容量 0)——每次发送都等待匹配的接收。生产者与消费者速率之间耦合最紧。用于按设计的背压。
Channel.BUFFERED——固定大小缓冲(默认 64)。仅当缓冲满时 send 才挂起。用于生产者不应因消费者而短暂阻塞的场景。
Channel.CONFLATED——缓冲为 1;新的 send 替换待处理的值。用于只关心最新值的场景(UI 更新、传感器读数)。
Channel.UNLIMITED——无界缓冲。极少使用——在持续不匹配的情况下堆会无界增长。几乎总是错误的默认值。
produce { … }——单生产者便捷方式。从通过 send 发射的协程构建一个 ReceiveChannel<T>:
fun CoroutineScope.numbers(): ReceiveChannel<Int> = produce { for (n in 1..10) send(n) }
当 produce 协程完成时,channel 自动关闭。
扇出(一个生产者,多个工作协程)。许多消费者从单个 channel 竞争元素;每个值恰好进入一个消费者。
val tasks = produce { ... } repeat(4) { workerId -> launch { for (task in tasks) process(workerId, task) } }
扇入(多个生产者,一个消费者)。许多生产者向共享 channel 发送;一个消费者读取。
val results = Channel<Result>() sources.forEach { src -> launch { results.send(src.compute()) } } launch { for (r in results) collect(r) }
关闭。channel.close() 表示“没有更多值”。接收者在排空缓冲值后会看到 channel 已关闭。for (x in channel) 在关闭时干净退出。向已关闭的 channel 发送会抛出 ClosedSendChannelException。
决策启发式
优先默认使用 Flow。仅当你确实有多个协程作为发送者或接收者时才使用 Channel。
RENDEZVOUS 是正确的默认容量。更紧的耦合能及早发现生产者/消费者速率不匹配。
没有硬性理由绝不使用 UNLIMITED 容量——背压是一种特性。
生产完成后始终关闭 channel;长期存在且没有关闭者的生产者会泄漏协程。
反模式
将 Channel.UNLIMITED 作为默认——负载下堆无界增长。
持有 channel 引用却从不关闭——接收者永远阻塞;父协程永远无法完成。
在 Flow 就足够时却用 channel 实现单生产者 / 单消费者流——额外的仪式感而无收益。
共享 channel 却没有明确的所有权——close() 上的竞态条件(关闭两次会抛异常)。
将 channel 与共享可变状态混用——破坏了消息传递的优势。
另见
kp-select——在多个 channel(或 channel + deferred)之间多路复用。
kp-actor-pattern——通过 channel 将可变状态限制在协程之后。
kp-flow-cold-vs-hot——何时使用 Flow / SharedFlow / StateFlow 而非 Channel。
kp-structured-concurrency——channel 及其拥有的作用域。
参考资料
Kotlin Coroutines(Marcin Moskała)——关于 Channels、produce、fan-out/fan-in 的专门章节。
Kotlin 协程官方指南——channels 和异步 flow。