跨平台开发 / 系统课时

用 mock 替换外部依赖

用 mock 替换外部依赖

本篇解决业务逻辑测试中网络、数据库等外部依赖不可控的问题,通过 mock 隔离真实资源,让测试可以稳定重复执行,并验证业务代码是否正确处理依赖返回值。

学习目标

  • 理解为什么单元测试需要替换外部依赖
  • 使用 mock 模拟 Repository 等外部服务行为
  • 编写可验证成功和失败分支的 Flutter 单元测试

为什么单元测试需要 mock

单元测试关注的是当前代码的业务逻辑,而不是网络连接、数据库状态或第三方服务是否可用。如果测试直接调用真实依赖,测试结果会受到环境、网络和数据状态影响。

例如,一个登录业务类依赖用户接口。如果每次测试都请求真实服务器,那么接口延迟、服务异常或者测试账号变化都会导致测试不稳定。mock 的作用就是提供一个可控的替代对象,让测试只关注业务判断。

在 Flutter 项目中,通常会 mock Repository、数据源、客户端或系统服务,而不是 mock 被测试的业务类。

使用 mockito 替换 Repository

Flutter 中常用 mockito 创建模拟对象。下面示例测试一个依赖用户仓库的登录服务。

dart
import 'package:flutter_test/flutter_test.dart';
import 'package:mockito/mockito.dart';

class User {
  final String name;
  User(this.name);
}

abstract class UserRepository {
  Future<User> fetchUser();
}

class MockUserRepository extends Mock implements UserRepository {}

class UserService {
  final UserRepository repository;

  UserService(this.repository);

  Future<String> loadUserName() async {
    final user = await repository.fetchUser();
    return user.name;
  }
}

void main() {
  test('returns user name from repository', () async {
    final repository = MockUserRepository();
    final service = UserService(repository);

    // 控制外部依赖返回固定数据,避免访问真实数据源
    when(repository.fetchUser())
        .thenAnswer((_) async => User('Alice'));

    final result = await service.loadUserName();

    expect(result, 'Alice');
    verify(repository.fetchUser()).called(1);
  });
}

预期输出

text
00:00 +1: returns user name from repository
00:00 +1: All tests passed!

测试中 when 定义 mock 行为,verify 检查依赖是否按照预期被调用。这样既验证了业务结果,也确认了依赖交互过程。

mock 的使用边界

mock 并不是越多越好。过度 mock 会让测试只验证调用关系,而无法发现真实协作问题。

适合使用 mock 的场景包括:

  • 网络 API 请求
  • 本地数据库访问
  • 文件系统操作
  • 时间、随机数等不可预测资源

不适合 mock 的场景包括:

  • 简单的数据模型
  • 纯函数计算
  • 当前模块内部已经稳定的业务逻辑

一个好的单元测试应该模拟变化来源,而不是模拟所有对象。

设计容易测试的业务代码

如果一个类直接创建 HTTP 客户端或数据库连接,测试时很难替换依赖。更推荐通过构造函数注入依赖。

例如:

dart
class OrderService {
  final OrderRepository repository;

  OrderService(this.repository);
}

业务类只依赖抽象接口,测试时传入 mock,实现代码时传入真实实现。

这种设计可以降低耦合,同时让测试更加稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 mock 替换外部依赖

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

登录哪都通