1 / 4概念
Error
C 把错误当成普通数据:函数返回一个值,失败信息放在返回值、errno 或出参里。没有栈展开,也没有析构函数,所以“失败时把已获取的资源还回去”必须由控制流显式表达。
1 概念
1.1 一句话定义
C 的错误处理是约定:成功与失败由返回值区分,系统调用把原因写进线程局部的 errno,深层失败用 goto 集中清理,只有需要跨越大量栈帧时才用 setjmp/longjmp。
1.2 它解决什么问题
- 失败显式:每个可失败调用都要在调用点被处理,不能悄悄跳过。
- 零开销:没有异常表与栈展开,失败路径只是一次返回。
- 与 POSIX 对齐:
errno与系统调用、libc 的错误码是同一套词汇。 - 清理可靠:单一出口的
goto cleanup让每条失败路径都经过同一段释放代码。 - 跨层跳转:解析器、解释器这类深层嵌套场景用
longjmp一次退回入口。
代价是样板多、容易漏检返回值,且每种通道都有细微的失效条件。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 函数原型、返回值与链接 | Functions |
| 堆分配与对象生命周期 | Runtime: Memory Layout and Allocation |
| 信号处理与阻塞 | Async |
线程与 errno 的线程局部性 | Concurrency |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
errno | 最近一次失败的错误码,线程局部 | 成功时不会被清零 |
| 哨兵值 | 用 NULL、-1 等特殊值表示失败 | 合法值可能与哨兵重叠 |
| 出参 | 通过指针返回结果或错误 | 调用方必须先初始化 |
goto cleanup | 跳到统一释放段 | 不是异常,不展开栈 |
setjmp/longjmp | 保存与恢复执行环境 | 不是栈展开,不调用析构 |
EINTR | 系统调用被信号中断 | 必须显式重试 |
2 机制
2.1 心智模型
错误是返回值的一部分,清理是控制流的一部分。 函数用返回值表达“成功/失败”,用 errno 或出参表达“为什么”;调用方在失败时跳到统一清理段,按获取的逆序释放。longjmp 只是把这条清理路径跳过去,所以它绕过的锁、缓冲区与临时文件都要由调用方自己补。
2.2 机制拆解
- 返回值与
errno分工:返回值回答“有没有失败”,errno回答“为什么”;只检查errno而不检查返回值会读到上一次的旧错误。 errno不清零:成功的调用不会把errno置 0;若要在失败后读errno,应在调用前置 0,且只在返回值表明失败时读。- 清理顺序:按获取的逆序释放;每一步都判空或判
>= 0,这样失败在任何一步都能走同一条清理路径。 - 保留原始错误:清理函数(
free、close、fprintf)可能改写errno;进入清理段先存int saved = errno;,退出前恢复。 EINTR与部分写:read/write可能被信号中断或只完成一部分;EINTR重试,短写要循环推进偏移。setjmp/longjmp:只能跳回仍然存活的栈帧;longjmp之后,未声明为volatile且在被调函数内修改的局部变量值不确定;跳转不会释放锁与内存。
2.3 完整枚举
C 的错误通道,这是完整集合:
| 通道 | 适用场景 | 失效模式 |
|---|---|---|
| 哨兵返回值 | 指针返回 NULL、整数返回 -1 | 合法值与哨兵重叠 |
| 错误码返回值 | 返回 0 或负的 errno 值 | 调用方忽略返回值 |
errno | 系统调用与 libc | 成功不清零、清理时被覆盖 |
| 输出参数 | 需要同时返回结果与错误 | 调用方忘记初始化 |
goto cleanup | 多资源、多失败点 | 清理顺序错、漏判空 |
setjmp/longjmp | 深层嵌套一次退出 | 跳过锁与内存释放、局部变量失效 |
abort/assert | 不可恢复的内部错误 | 在生产环境禁用 assert 后失效 |
| 信号 | 异步事件与致命错误 | 处理函数只能调用异步信号安全函数 |
3 实践
3.1 最小示例与追踪
示例把打开、分配、读、写放进同一条清理路径,并在清理前保存 errno。
#include <errno.h>
#include <fcntl.h>
#include <stdlib.h>
#include <unistd.h>
int copy_file(const char *src, const char *dst)
{
int in = -1, out = -1, rc = -1;
char *buf = NULL;
in = open(src, O_RDONLY);
if (in < 0) goto done;
out = open(dst, O_WRONLY | O_CREAT | O_TRUNC, 0644);
if (out < 0) goto done;
buf = malloc(4096);
if (buf == NULL) goto done;
for (;;) {
ssize_t n = read(in, buf, 4096);
if (n < 0) { if (errno == EINTR) continue; goto done; }
if (n == 0) break;
for (ssize_t off = 0; off < n;) {
ssize_t w = write(out, buf + off, (size_t)(n - off));
if (w < 0) { if (errno == EINTR) continue; goto done; }
off += w;
}
}
rc = 0;
done: {
int saved = errno; /* 清理可能改写 errno */
free(buf);
if (out >= 0) close(out);
if (in >= 0) close(in);
errno = saved;
return rc;
}
追踪:任一失败点都跳到 done,此时 in、out、buf 的初值保证不会误释放未获取的资源。saved 在 free 与 close 之前保存,否则调用方读到的 errno 可能变成 EBADF 或 ENOMEM。短写用内层循环推进 off,否则大文件会静默丢数据;EINTR 只重试当前调用,不重新打开文件。注意这个函数不是原子的:写到一半失败时目标文件已被截断,调用方要么删除它,要么先写临时文件再 rename。
3.2 选型矩阵
| 场景 | 通道 | 理由 | 风险 |
|---|---|---|---|
| 单层调用、失败原因简单 | 返回码 | 最直接,零开销 | 容易漏检 |
| POSIX 系统调用 | 返回码加 errno | 与平台一致 | errno 被覆盖 |
| 多资源获取与释放 | goto cleanup | 单一出口,顺序可控 | 标签顺序写错 |
| 解析器深层递归 | setjmp/longjmp | 一次退出所有层 | 跳过锁与释放 |
| 程序员错误 | assert | 立即暴露 | 发布版被禁用 |
| 不可恢复的破坏 | abort | 不带着坏状态继续 | 丢失现场,需 core dump |
3.3 决策规则
- 每个可失败调用的返回值都要检查;不需要处理时显式写
(void)并注释原因。 - 需要读
errno时先清零,失败后立刻保存,清理结束后再恢复。 - 资源清理写成单一出口,按获取逆序释放,指针初值设为
NULL、描述符初值设为-1。 - 能用
goto cleanup就不要用longjmp;只有跨越多层框架代码时才考虑后者。 - 对外接口用文档写明:返回 0 成功、负数失败、失败时
errno有效。
4 边界
4.1 典型故障
| 症状 | 根因 | 诊断 | 修复 |
|---|---|---|---|
报错原因总是 ENOENT | 读了未清零的旧 errno | 在调用前后各打印一次 | 先清零,只在失败时读 |
清理后错误码变成 EBADF | close 覆盖了原始 errno | 在 done 段打印 errno | 进入清理前保存,退出前恢复 |
| 大文件复制后尾部缺失 | write 短写未循环 | 统计写入字节数 | 循环推进偏移直到写完 |
| 慢系统调用频繁失败 | 未处理 EINTR | strace 看到 ERESTARTSYS | 对幂等调用重试 |
| 失败路径泄漏内存 | 某个 goto 跳过了释放 | ASan 或 valgrind 报泄漏栈 | 所有失败点跳到同一标签 |
longjmp 后死锁 | 跳过了 pthread_mutex_unlock | gdb 看线程持锁状态 | 在跳转前显式解锁,或改用返回码 |
longjmp 后局部变量值错乱 | 变量未声明 volatile | 对比 -O0 与 -O2 | 声明 volatile 或改为静态存储 |
4.2 安全 / 性能 / 一致性边界
- 安全边界:错误信息不能包含未验证的外部输入;失败时必须 fail closed,不能“记录后继续”。
- 一致性边界:
errno是线程局部但不是协程局部;同一线程内切换上下文前必须保存。 - 性能边界:返回码几乎零成本;
setjmp会阻止优化,异常路径才用。 - 可移植性边界:
errno的取值集合随平台变化;跨平台接口应自己定义稳定错误码并映射。