io_uring不能直接封装http请求，仅异步化socket系统调用；需手动封装accept/recv/send/connect等底层操作，并构建协议逻辑。
不能直接封装“网络请求”——io_uring 本身不处理 HTTP 或协议层，只负责 socket 系统调用的异步化。你要封装的是 accept、recv、send、connect 这些底层操作，再在其上构建协议逻辑。
为什么不能像 libcurl 那样直接 co_await http_get("...")
io_uring 是内核提供的异步系统调用接口，不是应用层协议栈。它支持 IORING_OP_ACCEPT、IORING_OP_RECV、IORING_OP_SEND、IORING_OP_CONNECT 等 opcode，但不识别 URL、HTTP 方法或状态码。所谓“封装网络请求”，实际是把 socket 的生命周期和数据收发流程用 io_uring 驱动起来。
- 常见错误：试图在
await_ready()里调connect()或send()—— 这会退化成同步阻塞，协程线程卡死 - 必须提前设置 socket 为非阻塞：
fcntl(fd, F_SETFL, O_NONBLOCK)，否则recv在无数据时仍可能挂住 - io_uring 不自动管理连接状态，
connect失败（如 EINPROGRESS 后 ECONNREFUSED）需在await_resume()中用getsockopt(fd, SOL_SOCKET, SO_ERROR, ...)显式检查，否则静默失败
如何用 io_uring 封装 accept + recv 流程
典型 Echo 服务器中，一个连接的生命周期需要串行触发：accept → set nonblock → recv → send → close。每一步都应提交独立 SQE，并靠 user_data 绑定上下文。
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
- 监听 socket 必须先注册：
io_uring_prep_register_files(sqe, &listen_fd, 1)，后续用索引代替 fd，避免每次查 fd 表开销 -
accept请求用io_uring_prep_accept(sqe, listen_fd_idx, addr, addrlen, SOCK_NONBLOCK)，注意传SOCK_NONBLOCK，省去后续 fcntl 调用 - 新连接 fd 也要立即注册（如果复用频繁），否则后续
recv提交时可能因未注册而返回-EBADF - 每个
recv需分配独立 buffer，且 lifetime 必须覆盖到 CQE 被收割；别用栈变量地址赋给sqe->addr
注册文件描述符和缓冲区是性能分水岭
不注册就用原始 fd 提交，每次 io_uring_submit() 都要走 fd 查表、引用计数、权限校验——高并发下 CPU 开销陡增。注册后所有 I/O 操作都走索引，接近零开销。
- 注册 fd：
io_uring_prep_register_files(sqe, fds_array, count)，fds_array必须是连续整数数组（不能有空洞） - 注册 buffer：
io_uring_prep_provide_buffers(sqe, buf_array, len, nbufs, bgid, bid_start)，之后recv可指定bgid和bid直接复用预分配内存，避免每次 mmap 或 malloc - 注册失败（如
io_uring_submit_and_wait返回负值）会导致后续所有使用该注册项的操作报-EBADF或-EINVAL，必须检查 errno（如-EPERM表示未启用IORING_SETUP_REGISTERED_FD）
收割 CQE 时最容易忽略的三件事
很多人只关注 submit，却在 CQE 处理阶段掉坑：内存泄漏、重复释放、上下文错位。
-
sqe->user_data是唯一能关联请求与上下文的字段，必须在io_uring_prep_*()后立即设置，且指向堆内存（如new read_context），不能是局部变量或智能指针临时对象 - 收割到 CQE 后，
cqe->res是实际返回值：正数是字节数，-EAGAIN表示暂无数据（对非阻塞 recv 合法），-ECONNRESET或-EPIPE需主动 close 并清理上下文 - 必须确保所有 CQE 被
io_uring_cqe_seen()标记，否则内核不会推进 CQ head，下次io_uring_peek_cqe()会卡住；不要只 peek 不 seen
真正难的不是提交请求，而是让整个生命周期——从 fd 创建、注册、请求提交、CQE 收割、buffer 回收、上下文析构——全部在无锁、无竞态、无内存泄漏的前提下跑通。尤其是多连接场景下，user_data 指针一旦错绑或提前 delete，就会导致段错误或静默丢包，这种 bug 很难复现。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
