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<: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
<h3>容易被忽略的关键点</h3>
<p>很多人卡在看似“协程写了，却没反应”，其实问题不在协程语法，而在基础设施缺失：</p>
<ul>
<li>
<code>co_spawn</code> 的第三个参数决定协程生命周期——用 <code>boost::asio::detached</code> 表示不等待，但若 <code>io_context.run()</code> 返回前没触发任何异步操作，协程根本不会开始执行</li>
<li>HTTP 响应可能分多次到达，上面示例用 <code>async_read_some</code> 只读一次，遇到大响应或分包会截断；真实场景需用 <code>boost::beast::http::response_parser</code> 流式解析</li>
<li>超时必须手动加：<code>boost::asio::steady_timer</code> + <code>co_await timer.async_wait(...)</code> 并配合 <code>socket.cancel()</code>，标准协程不内置 timeout 语义</li>
<li>所有涉及堆内存的操作（如动态分配 parser、buffer）需注意协程挂起期间对象是否还有效——避免悬垂引用</li>
</ul>
<p>协程让异步代码线性化，但没降低网络编程本身的复杂度；把 <code>co_await</code> 当成“自动异步魔法”是最大的认知偏差。</p></void></:string>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
