Flutter运行报错type 'XFile' is not a subtype of type 'File' 求助

报错根因 #

你使用的image_picker在0.8.0及以上版本中，pickImage方法返回的结果类型是XFile，但Image.file构造方法只接收dart:io包下的File类型参数，直接传递XFile实例就会触发类型不匹配的运行时错误。

修复步骤 #

1. 首先在当前dart文件头部引入io库：

import 'dart:io';

2. 找到FutureBuilder中构建Image.file的代码行，将XFile实例通过它的path属性转换为File实例即可，修改后代码如下：

if (snapshot.hasData) {
  final imageFile = File(snapshot.data.path);
  return CustomPaint(
    child: Image.file(imageFile),
    foregroundPainter: MyRectPainter(rect: _rect),
  );
}

可选适配优化 #

如果要提升代码健壮性，适配空安全校验，可以补充类型判断和强制转换逻辑：

if (snapshot.hasData && snapshot.data != null) {
  final XFile xFile = snapshot.data as XFile;
  final File imageFile = File(xFile.path);
  return CustomPaint(
    child: Image.file(imageFile),
    foregroundPainter: MyRectPainter(rect: _rect),
  );
}

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