C++如何实现简单的异步HTTP GET协程任务

C++20协程自发布以来，一直有个尴尬的事实：std::coroutine本身只是一层语法糖，它不提供调度器，也没有封装好的异步socket接口——换句话说，协程并不天生具备异步I/O能力。于是很多人问，能不能用co_await直接对libcurl的阻塞函数下手？答案是：不行。这么做会导致线程阻塞，因为libcurl的easy_perform是同步操作，co_await没法把它变成真正的异步。

所以，要做一个可用的异步HTTP GET协程任务，真正有工程价值的方案只有两条路：要么用封装好的协程网络库，比如Boost.Asio + awaitable；要么自己基于libcurl的multi模式写轮询调度。后者复杂度高，容易踩坑，不推荐刚开始接触协程的朋友尝试。

用 std::coroutine + libcurl 做不了真正的异步GET

直接说结论：C++20 标准库不提供网络 I/O 协程支持。std::coroutine 只是语法糖，没有调度器、没有 awaitable 的 socket 封装。硬套 co_await 到 curl_easy_perform 上，结果是阻塞主线程——它根本不是异步函数。

真正可行的路径只有两条：用封装好的协程网络库，比如 Boost.Asio + awaitables 是主流方案；或者自己把 libcurl 置于 multi interface 模式 + 轮询 + 手动挂起恢复。后者复杂且易出错，不推荐初学者尝试。

boost::asio + awaitable 是目前最稳的方案

Boost 1.70+ 提供了完整的协程 HTTP 客户端支持，底层基于非阻塞 socket 和 io_context 调度，awaitable 可自然挂起等待连接/响应。你需要：

• 安装 Boost 1.75+（含 boost::beast）
• 链接 -lboost_system -lssl -lcrypto（HTTPS 必需）
• 启用 C++20 编译（-std=c++20）

下面是一个最小可运行 GET 示例（HTTPS）：

#include 
#include 
#include 
#include 
#include 
#include 

namespace asio = boost::asio;
namespace http = boost::beast::http;

asio::awaitable simple_get() {
    auto executor = co_await asio::this_coro::executor;
    asio::ip::tcp::resolver resolver{executor};
    asio::ssl::context ctx{asio::ssl::context::tlsv13_client};
    ctx.set_default_verify_paths();

    auto stream = std::make_shared>(
        asio::make_strand(executor), ctx);

    // 解析并连接
    auto results = co_await resolver.async_resolve("httpbin.org", "443", asio::use_awaitable);
    co_await stream->async_handshake(asio::ssl::stream_base::client, asio::use_awaitable);

    // 构造请求
    http::request req{http::verb::get, "/get", 11};
    req.set(http::field::host, "httpbin.org");
    req.set(http::field::user_agent, "Boost.Beast");

    // 发送并读响应
    http::write(*stream, req, asio::use_awaitable);
    boost::beast::flat_buffer buffer;
    http::response res;
    co_await http::async_read(*stream, buffer, res, asio::use_awaitable);

    // 打印状态码和前 100 字节 body
    std::cout << res.result_int() << "n";
    std::cout.write(boost::beast::buffers_begin(buffer.data()),
                    std::min(static_cast(100), buffer.size()));
}

别漏掉 co_spawn 启动和 io_context::run() 驱动

协程不会自动执行，必须显式启动。常见错误是只写了 simple_get() 却没调用 co_spawn，或者忘了 io_context.run() —— 这会导致程序立即退出，什么也不做。

正确入口写法：

int main() {
    asio::io_context ioc;
    asio::co_spawn(ioc, simple_get(), asio::detached); // 或者用 asio::redirect_error(..., ec)
    ioc.run(); // 阻塞直到所有任务完成
}

注意几点：

• co_spawn 第二个参数必须是 awaitable，不能是普通函数或 lambda（除非返回 awaitable）
• asio::detached 表示不关心完成结果；若需捕获异常，改用 asio::redirect_error(..., ec)
• ioc.run() 是单线程驱动；多核需配合 io_context.run_work_count 或多个 io_context 实例

HTTPS证书验证失败？先关校验再排查

本地调试时，stream->async_handshake 常因证书路径未设或系统 CA 不可用而报 sslv3 alert handshake failure 或 certificate verify failed。临时绕过验证（仅开发用）：

ctx.set_verify_mode(asio::ssl::verify_none); // ⚠️ 生产环境严禁

生产环境应：

• 调用 ctx.set_default_verify_paths()（依赖系统 OpenSSL 配置）
• 或显式加载 PEM 文件：ctx.use_certificate_chain_file("ca-bundle.crt")
• 确保目标域名在证书 Subject Alternative Name 中（比如用 http://httpbin.org 测试 HTTPS 会失败，必须用 https://httpbin.org）

最容易被忽略的是：Beast 默认不发送 Connection: close，长连接可能让后续请求复用旧 socket，导致超时或乱序。显式关闭可加：req.set(http::field::connection, "close");