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、日志或用户提示。

rust
#[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}"),
        }
    }
}

预期输出:

text
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 系列能把模糊的“没有值”转换成可传播、可记录、可映射到接口响应的错误原因,也更容易与后续的 ? 组合成清晰的错误处理链。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ok_or 把缺失值变成错误

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

登录哪都通