1 / 4概念
Error
C++ 同时提供异常、错误码与终止路径,三者不是替代关系,而是按“调用方能否恢复、是否允许抛异常、是否跨 ABI 边界”分工。判断标准是能否说清错误从哪一层产生、在哪一层被处理,以及失败路径上资源由谁释放。
1 概念
1.1 一句话定义
异常用 throw/catch 做非局部跳转,栈展开时析构已构造的自动对象;noexcept 声明函数不抛,违反即 std::terminate;错误码与 std::expected 把失败放进返回值;assert、std::abort 与 std::unreachable 处理不可恢复错误;资源清理统一交给 RAII。
1.2 它解决什么问题
- 构造函数没有返回值,只能用异常报告失败。
- 跨多层调用传播错误,避免每层手写错误码转发。
- 在无异常构建或 C ABI 边界用返回值表达失败。
代价是异常路径难以测试、错误码容易被忽略,且两套通道混用会失去一致性。
1.3 不属于本页的内容
RAII 的规则 0/5 与智能指针见 Feature: RAII;异常运行时、unwind 表与 -fno-exceptions 的 ABI 细节见 Runtime: Exception Unwinding;跨 C ABI 的错误映射见 C 模块;异步任务的异常传播见 Async。
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| exception | 用 throw 抛出的对象 | 不是错误码 |
| stack unwinding | 抛出后逐层销毁自动对象 | 不销毁 new 的裸资源 |
noexcept | 函数不抛异常的契约 | 违反即 terminate |
| error code | 用返回值表达失败 | 容易被忽略 |
std::error_code | 值 + 错误类别 | 适合系统与库边界 |
std::expected | 值或错误二选一 | C++23 起标准 |
assert | 调试期断言 | NDEBUG 下消失 |
| terminate | 无法继续时的终止路径 | 不是普通错误处理 |
2 机制
2.1 心智模型
异常是“控制流跳转 + 栈展开”;不抛时几乎零成本,抛出时按 unwind 表逐帧查找 handler。noexcept 是接口契约,编译器可据此优化,违反契约直接终止。错误码是“值返回 + 调用方检查”;std::expected 把“值或错误”放进同一类型,让忽略错误变得更难。RAII 决定失败路径上谁清理,异常只决定跳到哪里。
2.2 机制拆解
- throw/catch:按类型匹配,忽略顶层 cv,支持基类捕获;
catch从派生到基类排列;按引用捕获避免切片。 - 栈展开:销毁每个完整构造的自动对象;构造函数抛异常时,已构造的成员与基类会析构;析构函数抛异常会终止进程。
- noexcept:析构、移动构造与移动赋值通常应
noexcept;vector扩容据此选择移动或拷贝。 - 错误码:
enum class定义领域错误;std::error_code携带值、类别与消息;std::system_error包装系统错误。 - expected:
std::expected<T, E>提供has_value、value、error、value_or与and_then/transform组合。 - 边界规则:异常不得穿过 C ABI;线程入口与回调边界应捕获;构造函数失败优先抛异常。
2.3 完整枚举
C++ 的异常安全保证:
| 等级 | 保证 | 典型实现 | 失败症状 |
|---|---|---|---|
| 无抛出保证 | 操作绝不抛异常 | noexcept、swap、移动 | 声明了却抛出,直接终止 |
| 强保证 | 失败时回滚到操作前状态 | copy-and-swap、事务式更新 | 回滚不完整,状态半新半旧 |
| 基本保证 | 失败后对象仍有效,不泄漏 | RAII 成员、局部临时对象 | 不变量被破坏但无人发现 |
| 无保证 | 失败后状态未定义 | 裸资源、手工数组 | 泄漏、重复释放、崩溃 |
3 实践
3.1 最小示例
#include <cstdio>
#include <expected>
#include <stdexcept>
#include <string>
enum class ParseError { empty, not_a_number };
std::expected<int, ParseError> parse_int(const std::string& text) {
if (text.empty()) return std::unexpected(ParseError::empty);
int value = 0;
for (char c : text) {
if (c < '0' || c > '9') return std::unexpected(ParseError::not_a_number);
value = value * 10 + (c - '0');
}
return value;
}
struct File {
std::FILE* handle;
explicit File(const char* path) : handle(std::fopen(path, "r")) {
if (!handle) throw std::runtime_error("open failed");
}
~File() { if (handle) std::fclose(handle); }
File(const File&) = delete;
File& operator=(const File&) = delete;
};
int main() {
auto parsed = parse_int("42");
if (!parsed) {
std::printf("error %d\n", static_cast<int>(parsed.error()));
return 1;
}
std::printf("value %d\n", *parsed);
try {
File file("/definitely/not/here");
} catch (const std::exception& e) {
std::printf("file: %s\n", e.what());
}
}
追踪:parse_int 用 expected 返回错误,调用方必须检查 !parsed 才能安全解引用;*parsed 取出 42。File 构造函数在 fopen 失败时抛 runtime_error,此时对象未构造完成,析构不会运行;若构造成功,离开作用域时析构关闭文件。异常从 File 构造抛到 catch,期间已构造的 std::string 参数等自动对象会展开析构。
3.2 标准流程
- 先定义错误分类:可恢复、不可恢复、编程错误。
- 构造函数失败用异常;跨 C ABI 与无异常构建用错误码或
expected。 - 所有资源用 RAII 持有;析构函数不抛异常。
- 每个 catch 只处理它理解的错误,其余继续传播。
3.3 选型矩阵
| 场景 | 错误通道 | 注意 |
|---|---|---|
| 构造函数失败 | 异常 | 对象未完成构造,析构不运行 |
| 高频、可恢复失败 | std::expected | 调用方必须检查 |
| 系统/库边界 | std::error_code | 保留类别与消息 |
| 无异常构建 | 错误码或 expected | -fno-exceptions 下不能用 try |
| 跨 C ABI | 返回码 + 输出参数 | 异常不得穿越边界 |
| 异步任务 | exception_ptr 或 expected | 在 get/co_await 处重抛 |
3.4 决策规则
- 同一个模块只选一条主错误通道,避免异常与错误码混用。
- 析构函数、移动操作与
swap应noexcept;不确定时先测量与测试。 - 错误码必须可检查:
[[nodiscard]]、-Wunused-result、封装成expected。 - 跨边界统一在边界函数捕获并转换为目标语言的错误模型。
4 边界
4.1 典型故障
| 症状 | 根因 | 诊断 | 修复 |
|---|---|---|---|
| 退出作用域时 terminate | 析构函数抛异常 | 栈回溯、终止日志 | 析构内捕获并记录 |
noexcept 函数抛出后直接终止 | 契约被违反 | 捕获 std::terminate 调用栈 | 移除 noexcept 或内部处理 |
| catch 后对象被切片 | 按值捕获异常 | typeid 与虚调用检查 | 按 const& 捕获 |
| 异常穿过 C ABI 崩溃 | 跨语言边界未捕获 | 边界日志、ASan | 在边界内 catch (...) 并转错误码 |
expected 未检查就解引用 | 忽略返回值 | 编译器告警、测试 | [[nodiscard]] 与分支检查 |
| 错误码被静默忽略 | 调用方未检查 | -Wunused-result | 封装或强制检查 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 用异常做常规分支 | 抛出路径昂贵、难测试 | 返回值或 expected |
| 析构函数抛异常 | std::terminate | 捕获并记录 |
| 用错误码表达编程错误 | 调用方无法合理处理 | assert 或直接终止 |
4.2 安全 / 性能 / 一致性边界
- 安全:析构抛异常、跨 ABI 抛异常与
noexcept违约都会终止进程。 - 性能:异常不抛时近零成本;抛出路径昂贵。
expected与错误码把成本移到每次检查。