Flutter图片转InputImage用于文字识别时触发PlatformException错误

问题场景 #

在Flutter中使用Google ML Kit的Text Recognition API从处理后的图片提取文字时，将处理后图片转换为InputImage时触发错误。

相关代码 #

Future<void> _extractTextFromProcessedImage(img.Image image) async {
  final imgBytes = Uint8List.fromList(img.encodeJpg(image));
  final metadata = InputImageMetadata(
    format: InputImageFormat.yuv420,
    size:  Size(image.width.toDouble(), image.height.toDouble()),
    rotation: InputImageRotation.rotation0deg,
    bytesPerRow: 0); // ignored

  final inputImage = InputImage.fromBytes(bytes: imgBytes, metadata: metadata);

  try {
    final recognizedText = await textRecognizer.processImage(inputImage);

    setState(() {
      _extractedText = recognizedText.text;
    });
  } catch (e) {
    print('Error recognizing text: $e');
  }
}

错误日志 #

2024-12-07 15:02:38.583 14697-14697 ImageError com.example.image_text_extractor E java.lang.IllegalArgumentException
2024-12-07 15:02:38.596 14697-14887 flutter com.example.image_text_extractor I Error recognizing text: PlatformException(InputImageConverterError, java.lang.IllegalArgumentException, null, null)

关键细节 #

• 错误PlatformException(InputImageConverterError, java.lang.IllegalArgumentException)指向图片转换环节出问题
• 使用img.encodeJpg(image)将处理后图片编码为JPG字节数组
• 当前设置的图片格式为InputImageFormat.yuv420，不确定是否适配JPG字节流

我的疑问 #

1. InputImageFormat.yuv420是否是JPG图片的正确格式？如果不是，JPG应该用什么格式？
2. 目前的图片转换方式是否有误？传入InputImage.fromBytes()前需要怎么处理？
3. 有哪些解决这类图片转换PlatformException错误的建议？

依赖配置（pubspec.yaml） #

dependencies:
  flutter:
    sdk: flutter

  google_mlkit_text_recognition: ^0.14.0
  image_picker: ^1.1.2
  image: ^3.0.1

已尝试操作 #

• 使用encodeJpg(image)转换图片为字节数组
• 设置格式为InputImageFormat.yuv420（可能不适配JPG）
• 检查并传入了size、rotation、bytesPerRow等元数据参数

解答 #

1. 关于InputImageFormat的适配 #

InputImageFormat.yuv420不适用于JPG图片，YUV420是摄像头预览帧常用的原始格式。对于JPG编码的字节流，应该使用InputImageFormat.jpeg（确保使用SDK提供的对应枚举值，注意大小写匹配）。

2. 图片转换的正确方式 #

当前字节编码逻辑没问题，但元数据的格式参数错误，同时需注意以下细节：

• bytesPerRow参数：对于JPG来说，可设为image.width * 3（JPG编码后多为RGB格式，每个像素占3字节），也可传入0让SDK自动处理（部分版本支持忽略该参数）。
• 旋转参数匹配：如果处理后的图片无旋转，rotation0deg正确；若图片自带EXIF旋转信息（如相册选取的图片），需同步调整该参数。

修正后的元数据代码：

final metadata = InputImageMetadata(
  format: InputImageFormat.jpeg,
  size: Size(image.width.toDouble(), image.height.toDouble()),
  rotation: InputImageRotation.rotation0deg,
  bytesPerRow: image.width * 3,
);

3. 解决PlatformException的建议 #

• 格式严格匹配：确保InputImageFormat与字节流实际编码格式完全一致，这是最常见的错误诱因。
• 验证字节流完整性：将img.encodeJpg(image)生成的字节流保存为临时文件，检查图片是否能正常打开，排除编码损坏问题。
• 尝试其他构造方法：若fromBytes持续报错，可将处理后的图片保存为本地文件，使用InputImage.fromFile(File(path))构造，该方式会自动处理元数据，减少手动配置错误。
• 升级依赖版本：检查google_mlkit_text_recognition最新稳定版，旧版本可能存在格式转换bug，升级后可能解决问题。
• 平台级调试：在Android端查看完整错误栈，定位是参数错误还是字节流解析失败，精准排查问题。

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