Flutter单元测试遇MissingStubError：get方法存根不匹配问题排查

常见问题原因及解决方法 #

1. 存根的方法参数不匹配 #

Mockito对方法调用的参数匹配是严格的，如果测试中存根的get方法参数（比如Uri、请求头）和实际API调用中的参数不完全一致，就会触发MissingStubError。

解决方法：

• 确保存根的Uri和API调用生成的Uri完全一致，比如：

  // API调用中的Uri
  final apiUri = Uri.parse('https://www.googleapis.com/books/v1/volumes?q=isbn:9781234567890');
  // 测试中存根时精确匹配该Uri
  when(mockClient.get(apiUri)).thenAnswer((_) async => http.Response('{"items": [...]}', 200));
  

• 如果不需要精确匹配，使用Mockito的通配符any()来匹配任意参数，比如：

  when(mockClient.get(any<Uri>())).thenAnswer((_) async => http.Response('{"items": [...]}', 200));
  

  注意：如果API调用中传递了headers参数，存根时也要对应处理，比如when(mockClient.get(any<Uri>(), headers: anyNamed('headers')))。

2. 方法签名不匹配 #

http.Client的get方法有重载，比如是否携带headers参数，测试中存根的方法签名必须和实际调用的签名完全一致。

解决方法：
检查API调用中get方法的参数列表，比如如果API调用是：

await client.get(uri, headers: {'Accept': 'application/json'});

那么存根时必须包含headers参数的匹配：

when(mockClient.get(any<Uri>(), headers: anyNamed('headers'))).thenAnswer(...);

或者精确匹配headers内容：

when(mockClient.get(any<Uri>(), headers: {'Accept': 'application/json'})).thenAnswer(...);

3. 存根设置时机错误 #

如果存根是在API调用之后才设置的，或者mock对象被重新初始化，存根会失效。

解决方法：
将存根代码放在测试执行的最前面，或者在setUp函数中初始化mock并设置存根，确保在调用API函数前完成存根配置：

setUp(() {
  mockClient = MockClient();
  // 提前设置存根
  when(mockClient.get(any<Uri>())).thenAnswer((_) async => http.Response('{"items": [...]}', 200));
});

test('fetchBook returns a Book', () async {
  // 调用API函数
  final book = await fetchBook('9781234567890', client: mockClient);
  // 断言逻辑
});

4. 依赖注入未正确实现 #

如果API调用函数中直接创建了http.Client实例（比如await http.Client().get(...)），而不是通过参数注入MockClient，测试中的mock对象根本不会被使用，自然会触发错误。

解决方法：
修改API函数，将http.Client作为参数传入，实现依赖注入：

// 修改后的API函数
Future<Book> fetchBook(String isbn, {required http.Client client}) async {
  final uri = Uri.parse('https://www.googleapis.com/books/v1/volumes?q=isbn:$isbn');
  final response = await client.get(uri);
  // 解析response为Book对象
}

测试时传入MockClient实例：

test('fetchBook returns a Book', () async {
  final mockClient = MockClient();
  when(mockClient.get(any<Uri>())).thenAnswer((_) async => http.Response('{"items": [...]}', 200));
  
  final book = await fetchBook('9781234567890', client: mockClient);
  
  expect(book, isA<Book>());
});

内容的提问来源于stack exchange，提问作者Jaimin Modi