计算机网络 / 系统课时
io_uring异常完成怎么处理
io_uring异常完成怎么处理
io_uring 的 CQE 不应只分成“成功”和“失败”。对读写请求而言,完整成功、短 I/O、零字节、负错误码与取消都需要不同处理,否则容易出现数据截断、忙重试或把正常取消误报成线上故障。本课给出一条统一而可扩展的完成处理路径。
学习目标
- 正确解释
cqe->res的非负结果与负 errno - 区分完整 I/O、短 I/O、EOF、可重试错误和取消
- 设计统一完成入口,让单次请求只进入一次终态并正确释放资源
先理解 cqe->res
CQE 的 res 是操作结果,不是传统的 errno。当它小于 0 时,值本身就是 -errno,因此不要再读取线程局部的 errno;当它大于等于 0 时,含义取决于提交的操作。对 read/write 一类请求,它通常表示实际传输的字节数。
短 I/O 不是失败。请求 4096 字节却只完成 1024 字节时,应用必须根据协议语义继续提交剩余部分,或者把当前字节数交给上层解析。对 read 来说,res == 0 常表示 EOF;对 write 来说,零进展需要单独防止无限重提。

把完成处理收敛到一个入口
统一入口的关键不是把所有操作强行写成同一逻辑,而是先做公共分类,再交给操作类型自己的语义处理。请求上下文至少应保存操作类型、期望字节数、当前偏移、重试次数以及取消状态;user_data 只负责找到这个上下文,不要把裸 fd 当作唯一身份。
下面的程序模拟读写 CQE 的核心分类逻辑。生产代码可把 handleRwCompletion 的 res 参数直接替换为 cqe->res。
#include <errno.h>
#include <stddef.h>
#include <stdio.h>
static void handleRwCompletion(int isRead, int res, size_t requested) {
if (res < 0) {
int err = -res;
if (err == ECANCELED) {
puts("cancelled");
} else if (err == EAGAIN) {
puts("retryable");
} else {
puts("fatal error");
}
return;
}
if (res == 0) {
puts(isRead ? "eof" : "zero progress");
return;
}
if ((size_t)res < requested) {
printf("short io: %d/%zu\n", res, requested);
return;
}
printf("success: %d bytes\n", res);
}
int main(void) {
handleRwCompletion(1, 4096, 4096);
handleRwCompletion(1, 1024, 4096);
handleRwCompletion(1, 0, 4096);
handleRwCompletion(1, -ECANCELED, 4096);
handleRwCompletion(1, -EAGAIN, 4096);
handleRwCompletion(1, -EIO, 4096);
}预期输出
success: 4096 bytes
short io: 1024/4096
eof
cancelled
retryable
fatal error可用 cc -std=c11 -O2 cqe_result.c && ./a.out 编译运行。真实处理短 I/O 时,还要把 buffer 指针和 offset 向前推进已完成的字节数,否则重提会重复发送或覆盖已经处理的数据。
取消和重试要有边界
-ECANCELED 往往是控制流结果,例如显式取消、超时链路触发或关联请求被终止,不应默认当成同等级的 I/O 故障告警。还要区分“取消操作自己的 CQE”和“目标请求的 CQE”:提交取消请求后,取消操作会得到独立完成结果,而目标请求仍会再产生自己的完成,可能是 -ECANCELED,也可能因为竞态已经正常完成。不能仅凭取消操作完成就释放目标请求上下文。
对 -EAGAIN 这类允许重试的结果也不要无上限立即重提。是否重试必须结合具体操作,并设置最大次数或截止时间;一旦连接进入 closing,新重试必须停止。否则事件循环可能在故障期间把 CPU 消耗在无意义的重提上。
保证完成路径只收敛一次
异常完成最危险的资源问题是把多个完成事件误当成同一个终态。对普通 single-shot 请求,请求上下文只能在目标请求自己的终态 CQE 上释放;取消请求使用独立的 user_data。如果使用 multishot 操作,则一个提交本来就可能产生多个 CQE,必须结合 IORING_CQE_F_MORE 判断是否还能继续收到完成,不能在中间 CQE 提前释放上下文。
验证时至少覆盖完整 I/O、短 I/O、EOF、主动取消、超时取消、可重试错误和不可重试错误,并记录每类 CQE 的计数。若观察到 single-shot 请求出现两个终态、短 I/O 后 offset 未推进,或 closing 状态仍持续产生重试,就说明完成状态机仍有缺口。