Flutter OCR识别应用报错：空值转字符串异常致无限加载

核心错误原因 #

终端抛出的type 'Null' is not a subtype of type 'String' in type cast错误，源于变量类型定义错误+强制类型转换逻辑错误：空值被强制转为字符串触发异常，导致加载弹窗无法关闭，一直处于无限加载状态。

具体错误点与修复 #

1. 变量类型定义错误
   原代码将_image定义为Image?，但实际需要存储的是图片文件路径（字符串），应改为String? _imagePath;。

2. 图片选择逻辑错误
   原代码中_image = pickedFile as Image?;是错误转换，pickedFile是XFile类型，需取其path属性获取文件路径：

   if (pickedFile != null) {
     _imagePath = pickedFile.path;
   }
   

3. 图片展示逻辑错误
   原代码用File(_image as String)是错误用法，修正后直接使用存储的路径字符串：

   Image.file(
     File(_imagePath!),
     fit: BoxFit.fitWidth,
   )
   

4. 扫描逻辑的健壮性缺失

   • 扫描前需判断图片路径是否为空，避免无意义的OCR调用
   • 增加try-catch捕获异常，确保异常时能关闭加载弹窗
   • 每次扫描前清空_text，避免多次扫描内容叠加

完整修正后的代码 #

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  String _text = "";
  String? _imagePath; // 改为存储图片路径字符串
  final picker = ImagePicker();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("Text Recognition"),
        actions: [
          TextButton(
            onPressed: scanText,
            child: const Text(
              "Scan",
              style: TextStyle(color: Colors.white),
            ),
          ),
        ],
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: getImage,
        child: const Icon(Icons.add_a_photo),
      ),
      body: SizedBox(
        height: double.infinity,
        width: double.infinity,
        child: _imagePath != null
            ? Image.file(
                File(_imagePath!),
                fit: BoxFit.fitWidth,
              )
            : const Center(child: Text("请选择图片")),
      ),
    );
  }

  Future scanText() async {
    if (_imagePath == null) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text("请先选择一张图片")),
      );
      return;
    }

    showDialog(
      context: context,
      barrierDismissible: false,
      builder: (context) => const Center(
        child: CircularProgressIndicator(),
      ),
    );

    try {
      _text = ""; // 每次扫描前清空内容
      final inputImage = InputImage.fromFilePath(_imagePath!);
      final textRecognizer = TextRecognizer();
      final recognizedText = await textRecognizer.processImage(inputImage);

      for (TextBlock block in recognizedText.blocks) {
        for (TextLine line in block.lines) {
          _text += "${line.text}\n";
        }
      }

      Navigator.of(context).pop();
      if (mounted) {
        Navigator.of(context).push(
          MaterialPageRoute(builder: (context) => Details(_text)),
        );
      }
    } catch (e) {
      Navigator.of(context).pop();
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text("扫描失败：${e.toString()}")),
      );
    }
  }

  Future getImage() async {
    final pickedFile = await ImagePicker().pickImage(source: ImageSource.gallery);
    setState(() {
      if (pickedFile != null) {
        _imagePath = pickedFile.path;
      } else {
        print("No image selected");
      }
    });
  }
}

额外优化点 #

• 增加图片未选择时的提示文本
• 加入页面状态判断mounted，避免页面销毁后执行跳转导致内存泄漏
• 错误时展示具体异常信息，方便排查问题

内容的提问来源于stack exchange，提问作者Mou Rani Biswas