Rust / 系统课时
验证状态机与副作用变化
验证状态机与副作用变化
状态机测试的重点不是把每个私有字段都断言一遍,而是验证一次操作是否让对象进入正确状态,并产生预期的集合与外部副作用。这样既能覆盖核心业务规则,也能减少实现重构带来的测试脆弱性。
学习目标
- 能围绕状态迁移条件设计行为测试。
- 能验证集合变化与关键副作用,而不是依赖私有实现细节。
- 能识别哪些断言属于稳定契约,哪些只是当前实现。
从状态迁移开始
先把被测对象看成一个有明确状态和操作的黑盒。例如订单只有 Pending 与 Paid 两种业务状态,那么测试应关注“支付成功后是否变为 Paid”,而不是关注内部用了哪一个字段保存状态。
一个最小例子如下,代码直接放在 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"]);
}
}预期输出
running 1 test
test tests::pay_moves_state_and_records_event ... ok这里的两个断言分别对应两个稳定行为:订单状态完成迁移,以及支付事件被记录。它们共同覆盖了核心规则与副作用。
验证集合变化
集合型副作用常见于购物车条目、已处理 ID、权限集合或领域事件。测试时优先验证“加入、删除、去重、数量变化”等业务结果,而不是直接检查底层容器如何实现。
例如,若某操作要求一个事件只能记录一次,测试应把重复调用作为边界场景。这样可以捕获回归,又不会把 Vec、HashSet 等具体实现写死在测试意图里。
#[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");
}
}预期输出
running 1 test
test tests::recording_same_event_twice_keeps_one_entry ... ok减少对私有细节的依赖
一个常见坏味道是测试为了“覆盖更多”而大量检查内部字段、辅助方法调用次数或缓存布局。只要这些内容不是业务契约,重构时就会频繁破坏测试,即使外部行为没有改变。
可以把断言分成两层:第一层验证状态、返回值、集合内容和对外可观察副作用;第二层只在实现本身就是契约时,才检查更具体的细节。状态机测试通常应把第一层作为主体。
什么时候需要更细的副作用测试
当副作用本身具有业务意义时,应明确测试它。例如发送领域事件、追加审计记录、更新待处理集合等。如果副作用只是为了缓存、日志格式或内部优化,则通常不值得成为核心单元测试的断言对象。
一个好的状态机测试通常可以用“操作 → 状态变化 → 副作用变化 → 边界行为”描述。只要这些可观察结果稳定,内部结构怎样重构都可以保持测试通过。