Flutter中Image Cropper包资源路径错误问题及修复咨询

问题原因 #

你遇到的报错是因为Image.asset使用的是Asset打包路径（如images/rose1.png），但ImageCropper需要的是设备文件系统的绝对路径。Asset资源在APP安装后并非以原始相对路径存在于文件系统中，直接传入会导致文件不存在的断言错误。

解决步骤 #

1. 添加依赖
   在pubspec.yaml中引入path_provider库，用于获取应用的临时目录：

dependencies:
  flutter:
    sdk: flutter
  image_cropper: ^5.0.0 # 建议使用最新稳定版
  path_provider: ^2.1.1

2. 实现Asset转临时文件的工具方法
   创建方法将Asset资源复制到临时目录，返回真实文件路径：

import 'dart:io';
import 'package:flutter/services.dart';
import 'package:path_provider/path_provider.dart';

Future<String> getAssetTempFilePath(String assetPath) async {
  // 加载Asset资源的字节数据
  final byteData = await rootBundle.load(assetPath);
  // 获取应用临时目录
  final tempDir = await getTemporaryDirectory();
  // 创建临时文件（用原文件名避免命名冲突）
  final tempFile = File('${tempDir.path}/${assetPath.split('/').last}');
  // 将字节数据写入临时文件
  await tempFile.writeAsBytes(byteData.buffer.asUint8List());
  // 返回临时文件的绝对路径
  return tempFile.path;
}

3. 修改裁剪函数
   在_cropImage中先获取临时文件路径，再传给ImageCropper：

Future<void> _cropImage(BuildContext context) async {
  File? _croppedImage;

  // 获取Asset对应的临时文件绝对路径
  final sourcePath = await getAssetTempFilePath('images/rose1.png');

  final croppedImage = await ImageCropper().cropImage(
    sourcePath: sourcePath,
    aspectRatioPresets: [
      CropAspectRatioPreset.square,
      CropAspectRatioPreset.ratio3x2,
      CropAspectRatioPreset.original,
      CropAspectRatioPreset.ratio4x3,
      CropAspectRatioPreset.ratio16x9
    ],
    uiSettings: [
      AndroidUiSettings(
        toolbarTitle: '裁剪图片',
        toolbarColor: Colors.deepOrange,
        toolbarWidgetColor: Colors.white,
        initAspectRatio: CropAspectRatioPreset.original,
        lockAspectRatio: false,
      ),
    ],
  );

  if (croppedImage != null) {
    setState(() {
      _croppedImage = File(croppedImage.path);
    });
  }
}

原理说明 #

Asset资源是打包在APK/IPA中的，无法直接通过相对路径被文件系统访问。通过rootBundle读取Asset的字节数据，写入应用临时目录的文件后，就能得到ImageCropper可以识别的真实文件路径，从而解决文件不存在的错误。

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