Flutter Dio与Mockito单元测试：实现登录认证网络请求的全面指南

import 'package:dio/dio.dart';
import 'package:fluttertoast/fluttertoast.dart'; // 假设用于显示提示

// 假设 Apiservices 类中定义了 baseurl
class Apiservices {
  final String baseurl = 'https://your-api-base-url.com/oauth/token';
  // ... 其他API服务方法
}

class AuthService {
  String? accessToken;
  String? refreshToken;

  // 认证方法，接收 mobileNumber, password 和 Dio 实例
  Future<String?> authentication(String mobileNumber, String password, Dio dio) async {
    dynamic data = {
      "username": mobileNumber,
      "password": password,
      "grant_type": "password",
      "client_id": "client_id"
    };

    try {
      final response = await dio.post(Apiservices().baseurl, // 使用传入的dio实例和baseurl
          data: data,
          options: Options(headers: {
            "Content-Type": "application/x-www-form-urlencoded"
          }));

      if (response.statusCode == 200) {
        accessToken = response.data["access_token"];
        refreshToken = response.data["refresh_token"];
        Fluttertoast.showToast(msg: "Successfully Logged in");
        return accessToken;
      }
    } on DioError catch (e) {
      Fluttertoast.showToast(msg: "Something went wrong");
      return e.toString(); // 返回错误信息字符串
    }
    return accessToken; // 如果请求失败但不是DioError，或者其他情况，可能返回null或之前的值
  }
}

dev_dependencies:
  flutter_test:
    sdk: flutter
  mockito: ^5.4.0 # 使用最新版本

// test/auth_service_test.dart (或你的测试文件)
import 'package:flutter_test/flutter_test.dart';
import 'package:mockito/annotations.dart';
import 'package:mockito/mockito.dart';
import 'package:dio/dio.dart';
// 导入你的服务文件
import 'package:your_project_name/services/auth_service.dart'; // 替换为你的实际路径

// 告诉 Mockito 为 Dio 类生成一个 Mock 类
@GenerateMocks([Dio])
import 'auth_service_test.mocks.dart'; // Mockito 会在此文件生成 MockDio

void main() {
  // ... 你的测试代码
}

import 'package:flutter_test/flutter_test.dart';
import 'package:mockito/annotations.dart';
import 'package:mockito/mockito.dart';
import 'package:dio/dio.dart';
import 'package:your_project_name/services/auth_service.dart'; // 替换为你的实际路径

@GenerateMocks([Dio])
import 'auth_service_test.mocks.dart';

void main() {
  late MockDio mockDio; // 声明一个 MockDio 实例
  late AuthService authService; // 声明一个 AuthService 实例
  final String testBaseUrl = Apiservices().baseurl; // 获取认证服务使用的 baseurl

  // 定义一个模拟的成功登录响应数据
  final Map<String, dynamic> loginSuccessResponse = {
    "access_token": "mock_access_token_12345",
    "refresh_token": "mock_refresh_token_67890",
    "token_type": "Bearer",
    "expires_in": 3600
  };

  setUp(() {
    // 在每个测试运行前初始化 MockDio 和 AuthService
    mockDio = MockDio();
    authService = AuthService(); // AuthService 构造函数可能需要参数，请根据实际情况调整
  });

  group('AuthService - Login Authentication', () {
    test('should return access token on successful login', () async {
      // Arrange: 设置 MockDio 的行为
      when(
        mockDio.post(
          testBaseUrl, // 匹配 authentication 方法中使用的 baseurl
          data: anyNamed('data'), // 匹配任何数据体
          options: anyNamed('options'), // 匹配任何 Options 对象
        ),
      ).thenAnswer((_) async => Response(
            requestOptions: RequestOptions(path: testBaseUrl), // 模拟请求选项
            data: loginSuccessResponse, // 模拟成功响应数据
            statusCode: 200, // 模拟成功状态码
          ));

      // Act: 调用待测试的认证方法，传入模拟的 Dio 实例
      final result = await authService.authentication(
        "testuser",
        "testpassword",
        mockDio, // 传入 mockDio
      );

      // Assert: 验证结果是否符合预期
      expect(result, equals("mock_access_token_12345")); // 期望返回模拟的 access_token

      // 验证 Dio 的 post 方法是否被调用过一次，且参数正确
      verify(mockDio.post(
        testBaseUrl,
        data: anyNamed('data'), // 验证数据体是否传入
        options: anyNamed('options'), // 验证 Options 是否传入
      )).called(1);

      // 验证 Fluttertoast.showToast 是否被调用 (如果需要测试副作用)
      // 注意: 直接测试 Fluttertoast 比较困难，通常会 mock掉它或者在集成测试中验证
    });
  });
}

// 继续在 group('AuthService - Login Authentication', () { ... }); 内部添加
    test('should return error message on failed login (DioError)', () async {
      // Arrange: 设置 MockDio 在请求失败时抛出 DioError
      when(
        mockDio.post(
          testBaseUrl,
          data: anyNamed('data'),
          options: anyNamed('options'),
        ),
      ).thenThrow(
        DioError(
          requestOptions: RequestOptions(path: testBaseUrl),
          response: Response(
            requestOptions: RequestOptions(path: testBaseUrl),
            statusCode: 401, // 模拟 401 未授权错误
            data: {"message": "Invalid credentials"}, // 模拟错误响应体
          ),
          type: DioErrorType.response, // 明确错误类型为响应错误
          error: "Unauthorized", // 错误信息
        ),
      );

      // Act: 调用待测试的认证方法
      final result = await authService.authentication(
        "wronguser",
        "wrongpassword",
        mockDio,
      );

      // Assert: 验证结果是否包含 DioError 的字符串表示
      // 因为 authentication 方法在 DioError 时返回 e.toString()
      expect(result, contains("DioError [response]: StatusCode: 401")); // 匹配 DioError 的字符串表示
      expect(result, contains("Unauthorized")); // 验证错误信息是否包含在返回的字符串中

      // 验证 Dio 的 post 方法是否被调用过一次
      verify(mockDio.post(
        testBaseUrl,
        data: anyNamed('data'),
        options: anyNamed('options'),
      )).called(1);
    });