Rust / 系统课时

Mock 外部接口但不伪造核心逻辑

Mock 外部接口但不伪造核心逻辑

测试外部依赖时,最容易走向两个极端:完全依赖真实服务,导致测试慢且不稳定;或者把内部实现全部 Mock 掉,测试虽然很快,却几乎没有验证价值。本篇通过“边界替换、核心真实”的方式,判断应该 Mock 什么,以及怎样避免测试被实现细节绑住。

学习目标

  • 区分应该替换的外部边界与应该保留的核心业务逻辑
  • 用 trait 为外部客户端建立测试替身
  • 根据行为断言设计 Mock 测试,避免验证过多内部调用细节

先划清替换边界

假设订单服务需要调用支付网关。支付网关属于外部系统,真实请求涉及网络、凭证、延迟和失败状态,单元测试通常不应该每次都访问它。

但“支付成功后订单才能变为已支付”是核心业务规则,应该继续由真实业务代码执行。正确的测试边界通常是:Mock 支付网关,保留订单状态变更、金额校验和错误处理等逻辑。

可以用一条原则判断:被替换的对象应该是业务无法直接控制、且测试成本较高的外部边界;被验证的对象应该是当前模块真正承担的业务规则。

用 trait 隔离外部支付接口

下面定义一个最小的 PaymentGateway 接口。生产实现可以连接真实支付系统,测试实现则只返回预先确定的结果。示例保留核心订单逻辑,让测试真正验证支付结果如何影响订单状态。

rust
#[derive(Debug, PartialEq)]
enum PaymentStatus {
    Paid,
    Declined,
}

trait PaymentGateway {
    fn charge(&mut self, cents: u64) -> PaymentStatus;
}

struct FixedGateway {
    result: PaymentStatus,
    last_charge: Option<u64>,
}

impl PaymentGateway for FixedGateway {
    fn charge(&mut self, cents: u64) -> PaymentStatus {
        self.last_charge = Some(cents);
        // 测试替身只控制外部依赖结果,不复制订单业务规则。
        match self.result {
            PaymentStatus::Paid => PaymentStatus::Paid,
            PaymentStatus::Declined => PaymentStatus::Declined,
        }
    }
}

fn pay_order<G: PaymentGateway>(gateway: &mut G, amount_cents: u64) -> PaymentStatus {
    if amount_cents == 0 {
        return PaymentStatus::Declined;
    }

    gateway.charge(amount_cents)
}

fn main() {
    let mut gateway = FixedGateway {
        result: PaymentStatus::Paid,
        last_charge: None,
    };

    let status = pay_order(&mut gateway, 1_500);
    println!("status={status:?}, charged={}", gateway.last_charge.unwrap());
}

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

    #[test]
    fn successful_payment_is_reported_as_paid() {
        let mut gateway = FixedGateway {
            result: PaymentStatus::Paid,
            last_charge: None,
        };

        assert_eq!(pay_order(&mut gateway, 1_500), PaymentStatus::Paid);
        assert_eq!(gateway.last_charge, Some(1_500));
    }

    #[test]
    fn zero_amount_is_rejected_without_gateway_call() {
        let mut gateway = FixedGateway {
            result: PaymentStatus::Paid,
            last_charge: None,
        };

        assert_eq!(pay_order(&mut gateway, 0), PaymentStatus::Declined);
        assert_eq!(gateway.last_charge, None);
    }
}

预期输出

text
status=Paid, charged=1500

这个测试验证了两个业务行为:合法金额会把外部支付结果传回业务层,零金额则直接拒绝且不会调用外部网关。支付网关本身是否真的能够扣款,不属于这个单元测试的职责。

不要把 Mock 写成实现细节的录像

常见问题是把测试写成“必须先调用 validate,再调用 normalize,然后调用 charge 一次”,甚至要求内部方法按照固定顺序执行。这样的测试对重构非常敏感:只要内部实现变了,即使用户看到的业务结果完全没变,测试也会失败。

更稳定的断言应该围绕输入、输出和关键外部副作用。例如验证传给支付网关的金额正确、拒绝场景不会发起扣款、支付成功后返回 Paid。除非调用顺序本身就是业务契约,否则不要把它当成测试目标。

可以把边界测试关注点整理为:

测试对象 更适合验证什么 不应重点验证什么
外部支付网关替身 输入金额、返回成功或失败 网关内部实现
当前业务函数 状态转换、规则、错误处理 私有方法调用次数
真实集成测试 真实协议、序列化、网络协作 每个内部步骤的调用顺序

Mock 什么时候不够

如果问题本身就是 HTTP 序列化、鉴权头、数据库 SQL、消息协议或第三方 SDK 兼容性,仅靠 Mock 无法证明真实集成正常。这类场景应补充少量集成测试,让真实边界参与验证。

因此,Mock 不是“让测试更容易”的万能手段,而是一种成本控制工具。单元测试用替身隔离外部不确定性,核心逻辑保持真实;集成测试再负责确认真实边界之间确实能够协作。测试分层清楚后,既能减少网络和服务依赖,又不会因为 Mock 过度而失去对业务的验证价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

Mock 外部接口但不伪造核心逻辑

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

登录哪都通