Rust / 系统课时
用 ok_or 把缺失值变成错误
用 ok_or 把缺失值变成错误
Option<T> 只能表达“有值或没有值”,但进入业务校验、接口处理或服务边界后,调用者往往还需要知道“为什么缺失”。ok_or 和 ok_or_else 可以把 None 转换成带错误原因的 Result<T, E>,让缺失值进入统一的错误传播链。
学习目标
- 能把
Option<T>的None转换为明确的Result<T, E> - 理解
ok_or与ok_or_else在错误构造时机上的区别 - 能在参数校验和查找逻辑中选择合适写法
从“没有值”变成“失败原因”
Option<T> 适合表达值可能不存在,例如“请求里可能没有用户 ID”。但当后续逻辑要求这个值必须存在时,继续返回 Option 会丢失失败原因,此时可以把缺失语义升级为错误语义。
ok_or(error) 的规则很直接:Some(value) 变成 Ok(value),None 变成 Err(error)。因此它特别适合把“必填字段缺失”“查询结果不存在”等情况接入 Result 调用链。
一个完整的参数校验示例
下面的函数要求请求中必须存在 user_id。调用者拿到 Result 后,可以继续使用 ? 传播,也可以在更外层映射成 HTTP 400、日志或用户提示。
#[derive(Debug)]
struct Request {
user_id: Option<u64>,
}
fn require_user_id(request: &Request) -> Result<u64, String> {
// 只有缺失时才分配错误字符串,Some 分支没有这项成本。
request
.user_id
.ok_or_else(|| "缺少 user_id".to_string())
}
fn main() {
let requests = [
Request { user_id: Some(42) },
Request { user_id: None },
];
// 最外层根据 Result 决定如何呈现成功或失败。
for request in &requests {
match require_user_id(request) {
Ok(user_id) => println!("user_id={user_id}"),
Err(error) => println!("error={error}"),
}
}
}预期输出:
user_id=42
error=缺少 user_id这里没有手写 match 去拆 Option,转换规则集中在 ok_or_else 一处,调用方拿到的是带原因的 Result。
ok_or 和 ok_or_else 怎么选
两者的区别不在最终结果,而在错误值何时构造。ok_or(error) 会先计算 error,即使原值是 Some 也一样;ok_or_else(|| error) 只有遇到 None 时才调用闭包。
| 写法 | 错误构造时机 | 适合场景 |
|---|---|---|
option.ok_or(Error::Missing) |
立即构造 | 错误值很轻量,例如枚举常量 |
| `option.ok_or_else( | build_error())` |
因此,轻量枚举错误用 ok_or 往往更直接;错误构造涉及 String、format! 或上下文采集时,优先考虑 ok_or_else。
不要把所有 None 都当成错误
None 是否需要转成 Err,取决于业务语义。搜索不到可选备注、缓存未命中、用户没有设置头像,都可能是正常状态;只有当当前操作要求这个值必须存在时,才应该把它提升为失败。
当缺失确实代表失败时,ok_or 系列能把模糊的“没有值”转换成可传播、可记录、可映射到接口响应的错误原因,也更容易与后续的 ? 组合成清晰的错误处理链。