Flutter 测试策略 (Testing Strategy)

模块：模块十 · 架构与工程化
前置知识：Flutter 基础 Widget、异步编程、Riverpod/Provider

---

测试金字塔

Flutter 测试遵循经典的测试金字塔原则：

           ▲
          /△\
         / △ \     集成测试（少量）
        /──△──\    真机/模拟器运行，测试完整流程
       /   △   \
      /────△────\
     /     △     \  Widget 测试（中量）
    /      △      \ 不需要真机，测试 UI 组件
   /───────△───────\
  /        △        \ 单元测试（大量）
 /         △         \ 纯 Dart 测试，快速、稳定
────────────────────────

类型	速度	真机	测试范围	数量建议
单元测试	极快（ms）	❌	函数/类	70%
Widget 测试	快（s）	❌	UI 组件	20%
集成测试	慢（min）	✅	完整流程	10%

---

单元测试

基础测试结构

// test/features/products/domain/usecases/get_products_usecase_test.dart

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

import 'get_products_usecase_test.mocks.dart';

@GenerateMocks([ProductRepository]) // 自动生成 Mock 类
void main() {
  late GetProductsUseCase useCase;
  late MockProductRepository mockRepository;

  setUp(() {
    // 每个测试前重新初始化（避免状态污染）
    mockRepository = MockProductRepository();
    useCase = GetProductsUseCase(mockRepository);
  });

  group('GetProductsUseCase', () {
    final tProducts = [
      const Product(
        id: '1',
        name: '测试商品',
        price: 99.0,
        stockCount: 10,
        category: ProductCategory.electronics,
      ),
    ];

    test('成功时返回商品列表', () async {
      // Arrange（准备）：设置 Mock 的行为
      when(mockRepository.getProducts())
          .thenAnswer((_) async => Right(tProducts));

      // Act（执行）：调用被测代码
      final result = await useCase(const GetProductsParams());

      // Assert（断言）：验证结果
      expect(result, Right(tProducts));
      verify(mockRepository.getProducts()).called(1); // 验证方法被调用了一次
      verifyNoMoreInteractions(mockRepository); // 验证没有其他调用
    });

    test('服务器失败时返回 ServerFailure', () async {
      // Arrange
      when(mockRepository.getProducts())
          .thenAnswer((_) async => const Left(ServerFailure(message: '500错误')));

      // Act
      final result = await useCase(const GetProductsParams());

      // Assert
      expect(result, const Left(ServerFailure(message: '500错误')));
    });

    test('使用正确的参数调用 repository', () async {
      // Arrange
      const params = GetProductsParams(page: 2, pageSize: 10);
      when(mockRepository.getProducts(page: 2, pageSize: 10))
          .thenAnswer((_) async => Right(tProducts));

      // Act
      await useCase(params);

      // Assert：验证参数传递正确
      verify(mockRepository.getProducts(page: 2, pageSize: 10)).called(1);
    });
  });
}