std::coroutine 不能直接发起 HTTP 请求，因为它仅提供挂起/恢复机制，无调度器、事件循环或 I/O 支持；必须依赖 boost.asio 等异步运行时，并手动处理 DNS、TLS、HTTP 协议及超时等细节。
为什么不能直接用 std::coroutine 发起 HTTP 请求
协程本身不处理 I/O，它只是提供挂起/恢复的机制；std::coroutine 是语言设施，不是运行时——没有调度器、没有事件循环、也不感知 socket。你写一个 co_await，编译器只生成状态机代码，底层仍需自己绑定到系统调用（如 epoll、IOCP 或 kqueue）。直接裸用标准库协程发 HTTP，等于徒手造轮子：没网络栈、没 DNS 解析、没 TLS、没连接池。
必须依赖第三方异步运行时才能跑起来
目前主流选择只有两个能真正落地：libcurl + curl_easy_setopt(CURLOPT_WRITEFUNCTION, ...) 配合自定义 awaiter，或更现代的 boost.asio（v1.79+ 支持 C++20 协程）+ boost::asio::use_awaitable。其中后者更符合“纯 C++20 协程”预期，但要注意：boost::asio::ip::tcp::socket 的 async_connect、async_read 等成员函数必须显式启用协程支持（即传入 boost::asio::use_awaitable），否则仍是传统回调风格。
-
boost::asio::io_context必须在调用协程前已启动（io_context.run()或io_context.run_one()） - DNS 解析要用
boost::asio::ip::tcp::resolver::async_resolve，不能用阻塞版resolve - HTTP 协议需手动拼接请求头（
"GET / HTTP/1.1\r\nHost: example.com\r\nConnection: close\r\n\r\n"），boost::beast可简化，但它不是标准库，需额外链接 - SSL/TLS 需搭配
boost::asio::ssl::stream，且证书验证逻辑要自己补全（否则默认不校验）
一个最小可跑通的 GET 示例（基于 boost::asio + beast）
以下代码假设已安装 Boost 1.81+，并链接 -lboost_system -lboost_asio -lboost_beast：
boost::asio::awaitable<std::string> http_get(std::string host, std::string target) {
auto executor = co_await boost::asio::this_coro::executor;
boost::asio::ip::tcp::resolver resolver{executor};
boost::asio::ip::tcp::socket socket{executor};
auto const results = co_await resolver.async_resolve(host, "80", boost::asio::use_awaitable);
co_await boost::asio::async_connect(socket, results, boost::asio::use_awaitable);
// 手动构造 HTTP/1.1 GET 请求
std::string req_str = "GET " + target + " HTTP/1.1\r\n"
"Host: " + host + "\r\n"
"Connection: close\r\n\r\n";
co_await boost::asio::async_write(socket, boost::asio::buffer(req_str), boost::asio::use_awaitable);
// 读响应（简单起见，一次性读完，不处理 chunked）
std::string buf(8192, '\0');
auto n = co_await socket.async_read_some(boost::asio::buffer(buf), boost::asio::use_awaitable);
co_return buf.substr(0, n);
}
// 调用入口（必须在 io_context 上启动）
int main() {
boost::asio::io_context ioc;
boost::asio::co_spawn(ioc, []() -> boost::asio::awaitable<void> {
auto body = co_await http_get("httpbin.org", "/get");
std::cout << body << std::endl;
}, boost::asio::detached);
ioc.run();
}
容易被忽略的关键点
很多人卡在看似“协程写了，却没反应”，其实问题不在协程语法，而在基础设施缺失：
立即学习“C++免费学习笔记（深入）”；
-
co_spawn的第三个参数决定协程生命周期——用boost::asio::detached表示不等待，但若io_context.run()返回前没触发任何异步操作，协程根本不会开始执行 - HTTP 响应可能分多次到达，上面示例用
async_read_some只读一次，遇到大响应或分包会截断；真实场景需用boost::beast::http::response_parser流式解析 - 超时必须手动加：
boost::asio::steady_timer+co_await timer.async_wait(...)并配合socket.cancel()，标准协程不内置 timeout 语义 - 所有涉及堆内存的操作（如动态分配 parser、buffer）需注意协程挂起期间对象是否还有效——避免悬垂引用
协程让异步代码线性化，但没降低网络编程本身的复杂度；把 co_await 当成“自动异步魔法”是最大的认知偏差。
