Rust / 系统课时

验证状态机与副作用变化

验证状态机与副作用变化

状态机测试的重点不是把每个私有字段都断言一遍,而是验证一次操作是否让对象进入正确状态,并产生预期的集合与外部副作用。这样既能覆盖核心业务规则,也能减少实现重构带来的测试脆弱性。

学习目标

  • 能围绕状态迁移条件设计行为测试。
  • 能验证集合变化与关键副作用,而不是依赖私有实现细节。
  • 能识别哪些断言属于稳定契约,哪些只是当前实现。

从状态迁移开始

先把被测对象看成一个有明确状态和操作的黑盒。例如订单只有 Pending 与 Paid 两种业务状态,那么测试应关注“支付成功后是否变为 Paid”,而不是关注内部用了哪一个字段保存状态。

一个最小例子如下,代码直接放在 Rust 单元测试模块中即可运行:

rust
#[derive(Debug, PartialEq)]
enum Status {
    Pending,
    Paid,
}

#[derive(Debug)]
struct Order {
    status: Status,
    events: Vec<String>,
}

impl Order {
    fn new() -> Self {
        Self {
            status: Status::Pending,
            events: Vec::new(),
        }
    }

    fn pay(&mut self) -> Result<(), &'static str> {
        if self.status != Status::Pending {
            return Err("order is not pending");
        }
        self.status = Status::Paid;
        self.events.push("OrderPaid".to_string());
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn pay_moves_state_and_records_event() {
        let mut order = Order::new();

        order.pay().unwrap();

        assert_eq!(order.status, Status::Paid);
        assert_eq!(order.events, vec!["OrderPaid"]);
    }
}

预期输出

text
running 1 test
test tests::pay_moves_state_and_records_event ... ok

这里的两个断言分别对应两个稳定行为:订单状态完成迁移,以及支付事件被记录。它们共同覆盖了核心规则与副作用。

验证集合变化

集合型副作用常见于购物车条目、已处理 ID、权限集合或领域事件。测试时优先验证“加入、删除、去重、数量变化”等业务结果,而不是直接检查底层容器如何实现。

例如,若某操作要求一个事件只能记录一次,测试应把重复调用作为边界场景。这样可以捕获回归,又不会把 Vec、HashSet 等具体实现写死在测试意图里。

rust
#[derive(Default)]
struct EventLog {
    names: Vec<String>,
}

impl EventLog {
    fn record_once(&mut self, name: &str) {
        if !self.names.iter().any(|item| item == name) {
            self.names.push(name.to_string());
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn recording_same_event_twice_keeps_one_entry() {
        let mut log = EventLog::default();
        log.record_once("OrderPaid");
        log.record_once("OrderPaid");

        assert_eq!(log.names.len(), 1);
        assert_eq!(log.names[0], "OrderPaid");
    }
}

预期输出

text
running 1 test
test tests::recording_same_event_twice_keeps_one_entry ... ok

减少对私有细节的依赖

一个常见坏味道是测试为了“覆盖更多”而大量检查内部字段、辅助方法调用次数或缓存布局。只要这些内容不是业务契约,重构时就会频繁破坏测试,即使外部行为没有改变。

可以把断言分成两层:第一层验证状态、返回值、集合内容和对外可观察副作用;第二层只在实现本身就是契约时,才检查更具体的细节。状态机测试通常应把第一层作为主体。

什么时候需要更细的副作用测试

当副作用本身具有业务意义时,应明确测试它。例如发送领域事件、追加审计记录、更新待处理集合等。如果副作用只是为了缓存、日志格式或内部优化,则通常不值得成为核心单元测试的断言对象。

一个好的状态机测试通常可以用“操作 → 状态变化 → 副作用变化 → 边界行为”描述。只要这些可观察结果稳定,内部结构怎样重构都可以保持测试通过。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证状态机与副作用变化

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

登录哪都通