c++ asio协程用法 c++如何使用asio的awaitable进行异步编程-C++-PHP中文网

c++oding="utf-8" ?>

必须开启c++20协程支持并正确定义asio宏：clang加-std=c++20 -fcoroutines，gcc12+用-fcoroutines，msvc配/std:c++20 /await；#define asio_has_co_await需在#include 前；函数体内须含co_await才能生成协程逻辑。

c++ asio协程用法 c++如何使用asio的awaitable进行异步编程

asio::awaitable 编译前必须开 C++20 且启用协程支持

没开协程，awaitable 就是普通类模板，编译器根本不会把它当协程处理，所有 co_await 都报错。不是 ASIO 版本问题，是编译器开关没对。

Clang：加 -std=c++20 -fcoroutines -fno-exceptions -fno-rtti（ASIO 默认禁异常/RTTI，别漏）
GCC 12+：用 -std=c++20 -fcoroutines，但注意 GCC 对 ASIO 协程支持不如 Clang 稳定，容易卡在 await_transform 解析上
MSVC：/std:c++20 /await，且项目属性里「C++ 语言标准」和「协程支持」两个地方都要勾
ASIO 头文件顺序很重要：#define ASIO_HAS_CO_AWAIT 必须在 #include <asio.hpp></asio.hpp> 前定义，否则 awaitable 类型压根不暴露

写一个能真正挂起的 awaitable 函数，不是套壳 return

很多人以为只要返回 awaitable<t></t> 就算协程，其实函数体里没 co_await 或 co_return，编译器就当普通函数 inline 展开，根本不会生成 suspend/resume 逻辑。

C++

"空空如也"

下载

必须含至少一个 co_await 表达式，比如 co_await socket.async_read_some(...)
co_return 后面不能直接写值（除非 T 是 void），要匹配 awaitable<t></t> 的 T 类型；返回 void 用 co_return;
别在 awaitable 函数里 throw 异常——ASIO 的默认 executor 不捕获异常，会直接 terminate；改用 system_error 或显式 try/catch 包裹 co_await
示例片段：

asio::awaitable<:size_t> read_exactly(asio::ip::tcp::socket& sock) {
  std::array<char> buf;
  auto [ec, n] = co_await asio::async_read(sock, asio::buffer(buf), asio::use_awaitable);
  if (ec) co_return 0;
  co_return n;
}</char></:size_t>

asio::use_awaitable 不是万能适配器，只认特定 async_xxx 成员函数

use_awaitable 只能用于 ASIO 提供的、签名符合协程要求的异步成员函数，比如 socket.async_read_some、timer.async_wait。拿它去套自由函数（如 asio::async_read）或自定义 async 操作，编译直接失败。

正确用法只有两种：obj.async_xxx(..., asio::use_awaitable) 或 co_await obj.async_xxx(..., asio::use_awaitable)
自由函数如 asio::async_read、asio::async_write 不支持 use_awaitable，得换成对应对象的成员版（socket.async_read_some + 手动循环）
第三方 async 操作想接入协程，必须自己实现 awaitable 包装或提供 async_initiate 兼容接口，不能硬塞 use_awaitable
常见错误信息：no match for 'operator co_await'，基本就是用了不支持的函数签名

executor 绑定不显式传，就走默认，但默认可能不是你想要的

awaitable 函数默认绑定到调用它的那个 executor，但如果你在 thread_pool 里启动一个 awaitable，又在里面 co_await 了 steady_timer，timer 回调可能跑在系统线程（非 pool），导致数据竞争。

显式指定 executor：用 co_await asio::bind_executor(my_executor, timer.async_wait(asio::use_awaitable))
更安全的做法是在 awaitable 入口用 asio::this_coro::executor 捕获当前上下文，后续所有 co_await 自动继承
别依赖 asio::system_executor —— 它不保证线程安全，尤其在多线程 io_context::run() 场景下，容易出现 executor 切换抖动
调试时可加 std::cout 验证是否真在预期线程执行