C++20 协程:理解 co_await、promise 与生命周期

理解 C++20 协程,最重要的是分清三个事件:挂起、完成、销毁。挂起不等于完成,完成也不一定意味着协程状态已经销毁。 语言提供的三个关键字是 co_await、co_yield 和 co_return。下面用一个整数生成器串起它们背后的协议,重点回答:状态存在哪里、谁能恢复执行、结果如何交给调用者,以及最后由谁回收资源。 一、先分清五个角色 C++20 的协程是一种无栈协程:编译器为当前协程组织可挂起、可恢复的状态,而不是在每次暂停时保存整条普通函数调用栈。 角色 作用 容易混淆的地方 协程帧,coroutine frame 保存恢复执行需要的状态、promise、参数副本等 不等于每次 co_await 都把全部局部变量复制到堆上 promise 对象 定制启动、产值、完成、异常等行为 不是 <future> 中的 std::promise<T> std::coroutine_handle<Promise> 引用一个协程,提供恢复、观察和销毁操作 它不是自动管理生命周期的智能指针 返回对象 提供调用者使用的接口,例如后文的 IntGenerator 协程函数的返回类型不必是 coroutine_handle awaiter 实现一次等待的就绪判断、控制权交接和结果获取 源表达式中的 awaitable 不一定直接就是 awaiter 编译器通过 std::coroutine_traits<R, Args...>::promise_type 确定 promise 类型。把 promise_type 嵌套在返回类型 R 中是常见的默认用法,不是唯一可能;成员协程的类型推导还涉及隐式对象参数。 协程通常需要保存跨挂起点仍要使用的状态,但协程帧不意味着必然发生一次堆分配:编译器可以在满足条件时消除分配。更重要的是,帧的存在不会取消局部变量原有的作用域和析构规则。 二、co_await 是一套等待协议 对普通 co_await expression,编译器可能先调用 promise 的 await_transform,再通过 operator co_await 得到 awaiter。下面假定 awaiter 已经确定,只看三个核心方法。 await_ready():结果是否已经就绪? 返回 true 时,不进入挂起交接,直接调用 await_resume()。 await_suspend(handle):如何交接控制权? 当 await_ready() 返回 false,协程在进入这个方法之前就已被视为挂起。 await_resume():等待表达式得到什么? 它在直接就绪或恢复执行后运行,返回值及值类别决定 co_await 表达式的结果,也可以在这里抛出操作异常。 await_suspend 不只是一个“保存句柄的回调”。其正常返回时的行为取决于返回类型: ...

2026年9月26日 · 3 分钟 · Hellokitty

Mooncake 中的协程:从 coro_rpc 到同步接口桥接

Mooncake 确实使用了协程,但它并不是把整个系统改造成“全异步架构”。截至本文分析的主分支提交 3d1665a,协程主要出现在控制面 RPC、连接管理和阻塞任务卸载等 I/O 密集路径;对外接口仍大量保留同步调用形式。 这形成了一个很实用的分层:内部用 C++20 协程组织异步流程,边界处再按需要转换成同步返回值或回调。 技术栈 Mooncake 的协程代码主要建立在两层库之上: async_simple::coro::Lazy<T> 表示一个惰性异步任务; yalantinglibs 的 coro_rpc 和 coro_io 提供异步 RPC、网络连接与线程池调度。 典型代码形态如下: async_simple::coro::Lazy<Result> request() { auto response = co_await client.send_request(...); co_return response; } Lazy<T> 创建后通常不会立刻执行。它需要被另一个协程 co_await,通过 .start(...) 启动,或者由 syncAwait(...) 驱动至完成。 路径一:Mooncake Store 的 Master RPC mooncake-store/src/master_client.cpp 中的 MasterClient::invoke_rpc 是最清晰的例子。它的外部签名是同步的: tl::expected<ReturnType, ErrorCode> MasterClient::invoke_rpc(Args&&... args); 函数内部却先构造 Lazy,再连续等待两个异步阶段: return async_simple::coro::syncAwait( [&]() -> async_simple::coro::Lazy< tl::expected<ReturnType, ErrorCode>> { auto pending = co_await pool->send_request( [&](coro_io::client_reuse_hint, coro_rpc::coro_rpc_client& client) { return client.send_request<ServiceMethod>(...); }); if (!pending.has_value()) { co_return tl::make_unexpected(ErrorCode::RPC_FAIL); } auto result = co_await std::move(pending.value()); co_return result->result(); }()); 这里有两次 co_await: ...

2026年8月28日 · 2 分钟 · Hellokitty