计算机网络 / 系统课时

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 来说,零进展需要单独防止无限重提。

io_uring CQE 统一完成处理流程

把完成处理收敛到一个入口

统一入口的关键不是把所有操作强行写成同一逻辑,而是先做公共分类,再交给操作类型自己的语义处理。请求上下文至少应保存操作类型、期望字节数、当前偏移、重试次数以及取消状态;user_data 只负责找到这个上下文,不要把裸 fd 当作唯一身份。

下面的程序模拟读写 CQE 的核心分类逻辑。生产代码可把 handleRwCompletion 的 res 参数直接替换为 cqe->res。

c
#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);
}

预期输出

text
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 状态仍持续产生重试,就说明完成状态机仍有缺口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

io_uring异常完成怎么处理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通