Flutter集成测试中Mock ImagePicker无效，测试无法推进

我参考了两篇关于Flutter ImagePicker集成测试的文章，使用ImagePicker的代码如下：
final result = await ImagePicker().getImage(source: ImageSource.gallery);

测试时模拟器仍会打开图库，无法返回应用，导致测试中断。

补充说明
我写了Mock代码，但其中的handler从未被调用：

mockImagePicker(WidgetTester tester){
  print("Setting mockImagePicker starts");
  const MethodChannel channel =
  MethodChannel('plugins.flutter.io/image_picker');

  handler(MethodCall methodCall) async {
    print("Called method in mock method call is: ${methodCall.method}");
    print("mock handler called handler");
    ByteData data = await rootBundle.load('images/SplashScreen.png');
    Uint8List bytes = data.buffer.asUint8List();
    Directory tempDir = await getTemporaryDirectory();
    File file = await File('${tempDir.path}/tmp.tmp', ).writeAsBytes(bytes);
    print(file.path);
    return file.path;
  };

  channel.setMockMethodCallHandler((MethodCall methodCall) async {
    print("mock handler called setMockMethodCallHandler");
    return <String, String>{
      'type': 'image',
      'path': '/example/path',
    };
  });

  IntegrationTestWidgetsFlutterBinding?.instance?.defaultBinaryMessenger
      ?.setMockMethodCallHandler(channel, handler);
  tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(channel, (message) async {
    print("type 2 mock image");
    return await handler(message);
  });

}

请问我还遗漏了什么？

问题原因及修复方案 #

你的Mock失效主要有3个核心问题，按以下步骤修复即可：

1. 重复设置Mock导致覆盖
   你先后调用了3次Mock方法设置，后面的设置会直接覆盖前面的，导致最初定义的handler根本不会被执行，只需保留测试绑定的setMockMethodCallHandler即可。

2. MethodChannel名称不匹配
   新版本ImagePicker的Channel名称已分平台变更：Android为plugins.flutter.io/image_picker_android，iOS为plugins.flutter.io/image_picker_ios，旧的plugins.flutter.io/image_picker不再生效。

3. 返回值格式不符合插件要求
   ImagePicker的getImage方法期望返回包含path、name、size等字段的Map，而非直接返回文件路径。

修复后的Mock代码示例 #

void mockImagePicker(WidgetTester tester) async {
  print("Setting mockImagePicker starts");
  // 根据测试平台选择对应Channel
  const channel = MethodChannel('plugins.flutter.io/image_picker_android');

  final handler = (MethodCall methodCall) async {
    print("Called method: ${methodCall.method}");
    if (methodCall.method == 'pickImage') {
      // 加载测试图片并写入临时文件
      final ByteData data = await rootBundle.load('images/SplashScreen.png');
      final Uint8List bytes = data.buffer.asUint8List();
      final Directory tempDir = await getTemporaryDirectory();
      final File file = await File('${tempDir.path}/test_image.png').writeAsBytes(bytes);

      // 返回符合插件要求的格式
      return {
        'path': file.path,
        'name': 'test_image.png',
        'size': file.lengthSync(),
        'type': 'image/png',
      };
    }
    return null;
  };

  // 仅保留测试绑定的Mock设置
  tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(channel, handler);
}

额外注意事项 #

• 确保在测试初始化、pumpWidget之前调用这个Mock方法；
• 若同时测试iOS，需添加对应iOS的Channel设置，并保持返回格式一致；
• 测试结束后清除Mock，避免影响其他测试：

  tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(channel, null);
  

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