C / C++ / 系统课时
建立统一错误处理策略
建立统一错误处理策略
系统编程真正难处理的不是“调用失败”,而是失败后谁负责释放资源、错误如何继续向上传递,以及清理动作会不会覆盖原始错误。本节用一个可运行的文件复制程序建立统一约定:系统调用失败返回 -1,保留 errno,资源只由明确的所有者释放,并统一走清理路径。
学习目标
- 统一系统调用包装函数和业务函数的错误返回约定。
- 用明确的资源所有权与单一清理路径避免文件描述符泄漏。
- 在清理阶段保留首个关键错误,避免
close()等后续调用覆盖诊断信息。
错误契约先统一
在 C/Linux 中,最容易失控的是不同函数各自定义失败语义。一个实用约定是:成功返回 0 或有效值;失败返回 -1,并让 errno 描述直接原因。包装函数只处理可以在本层安全恢复的情况,例如 EINTR,其余错误继续交给调用者。
资源所有权也要写清楚:谁成功获得资源,谁负责释放;一旦把所有权转交给其他对象,原持有者就不再释放。 对文件描述符、堆内存、锁和映射区都应遵循同一规则。

用单一清理路径落实所有权
下面的主示例把两个文件描述符都交给 copy_file() 管理。write_all() 负责处理短写和被信号中断的写操作;copy_file() 只保留一个退出清理区,并在进入清理区前保存原始 errno。
#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 编译,再创建输入文件并验证复制结果:
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预期输出:
alpha
beta再验证失败路径不会 silent failure:
LC_ALL=C ./copy_file /no/such/file target.txt
printf 'exit=%d\n' "$?"预期输出:
copy_file: No such file or directory
exit=1容易踩坑的边界
不要在每一层都 perror() 一次,否则同一个失败会被重复打印;也不要在底层直接 exit(),否则上层失去释放其他资源和决定恢复策略的机会。对多个资源的函数,优先采用“初始化为无效值、成功获得后登记、统一清理”的模式。
清理函数本身也可能失败,因此需要区分“主操作已经失败”和“主操作成功但清理失败”。本例只在主操作成功时把 close() 失败提升为最终错误;若主操作已经失败,则保留更早的关键 errno。这套规则稳定后,后续再接结构化日志、重试或故障注入时,就不会因为错误语义混乱而扩大排查成本。