C / C++ / 系统课时

建立统一错误处理策略

建立统一错误处理策略

系统编程真正难处理的不是“调用失败”,而是失败后谁负责释放资源、错误如何继续向上传递,以及清理动作会不会覆盖原始错误。本节用一个可运行的文件复制程序建立统一约定:系统调用失败返回 -1,保留 errno,资源只由明确的所有者释放,并统一走清理路径。

学习目标

  • 统一系统调用包装函数和业务函数的错误返回约定。
  • 用明确的资源所有权与单一清理路径避免文件描述符泄漏。
  • 在清理阶段保留首个关键错误,避免 close() 等后续调用覆盖诊断信息。

错误契约先统一

在 C/Linux 中,最容易失控的是不同函数各自定义失败语义。一个实用约定是:成功返回 0 或有效值;失败返回 -1,并让 errno 描述直接原因。包装函数只处理可以在本层安全恢复的情况,例如 EINTR,其余错误继续交给调用者。

资源所有权也要写清楚:谁成功获得资源,谁负责释放;一旦把所有权转交给其他对象,原持有者就不再释放。 对文件描述符、堆内存、锁和映射区都应遵循同一规则。

统一错误传播与资源清理路径

用单一清理路径落实所有权

下面的主示例把两个文件描述符都交给 copy_file() 管理。write_all() 负责处理短写和被信号中断的写操作;copy_file() 只保留一个退出清理区,并在进入清理区前保存原始 errno。

c
#define _POSIX_C_SOURCE 200809L
#include <errno.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

static int write_all(int fd, const void *buf, size_t len) {
    const unsigned char *p = buf;

    while (len > 0) {
        ssize_t n = write(fd, p, len);
        if (n > 0) {
            p += (size_t)n;
            len -= (size_t)n;
            continue;
        }
        if (n == -1 && errno == EINTR) {
            continue;  // 信号中断不改变本层的失败语义,直接重试
        }
        if (n == 0) {
            errno = EIO;
        }
        return -1;
    }
    return 0;
}

static int copy_file(const char *src, const char *dst) {
    int in_fd = -1;
    int out_fd = -1;
    int rc = -1;
    int saved_errno = 0;
    unsigned char buf[4096];

    in_fd = open(src, O_RDONLY);
    if (in_fd == -1) {
        goto cleanup;
    }

    out_fd = open(dst, O_WRONLY | O_CREAT | O_TRUNC, 0644);
    if (out_fd == -1) {
        goto cleanup;
    }

    for (;;) {
        ssize_t n = read(in_fd, buf, sizeof buf);
        if (n > 0) {
            if (write_all(out_fd, buf, (size_t)n) == -1) {
                goto cleanup;
            }
            continue;
        }
        if (n == 0) {
            rc = 0;
            break;
        }
        if (errno != EINTR) {
            goto cleanup;
        }
    }

cleanup:
    if (rc == -1) {
        saved_errno = errno;  // 先保存主错误,避免清理动作覆盖 errno
    }
    if (out_fd != -1 && close(out_fd) == -1 && rc == 0) {
        rc = -1;
        saved_errno = errno;
    }
    if (in_fd != -1 && close(in_fd) == -1 && rc == 0) {
        rc = -1;
        saved_errno = errno;
    }
    if (rc == -1) {
        errno = saved_errno;
    }
    return rc;
}

int main(int argc, char **argv) {
    if (argc != 3) {
        fprintf(stderr, "usage: %s SRC DST\n", argv[0]);
        return 2;
    }
    if (copy_file(argv[1], argv[2]) == -1) {
        perror("copy_file");
        return 1;
    }
    return 0;
}

预期结果:保存为 copy_file.c 后,下面的 GCC 命令应成功生成 copy_file;复制成功时程序返回 0,系统调用失败时返回 1 并保留对应的 errno。

这里没有让 write_all() 打日志或退出进程,因为它并不知道调用场景。底层函数只返回失败事实;最外层的 main() 决定如何向用户报告并选择退出码,这样错误传播与用户界面不会耦合。

编译运行与验证

使用 GCC 编译,再创建输入文件并验证复制结果:

bash
gcc -std=c11 -Wall -Wextra -Wpedantic copy_file.c -o copy_file
printf 'alpha\nbeta\n' > source.txt
./copy_file source.txt target.txt
cat target.txt

预期输出:

text
alpha
beta

再验证失败路径不会 silent failure:

bash
LC_ALL=C ./copy_file /no/such/file target.txt
printf 'exit=%d\n' "$?"

预期输出:

text
copy_file: No such file or directory
exit=1

容易踩坑的边界

不要在每一层都 perror() 一次,否则同一个失败会被重复打印;也不要在底层直接 exit(),否则上层失去释放其他资源和决定恢复策略的机会。对多个资源的函数,优先采用“初始化为无效值、成功获得后登记、统一清理”的模式。

清理函数本身也可能失败,因此需要区分“主操作已经失败”和“主操作成功但清理失败”。本例只在主操作成功时把 close() 失败提升为最终错误;若主操作已经失败,则保留更早的关键 errno。这套规则稳定后,后续再接结构化日志、重试或故障注入时,就不会因为错误语义混乱而扩大排查成本。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立统一错误处理策略

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

登录哪都通