FlutterImageCompress压缩图片返回null 调用putFile报错如何解决

算力阿峰

2026-10-7

问题根因

报错的核心原因是FlutterImageCompress.compressAndGetFile执行失败返回了null，后续直接将null传入Firebase Storage的putFile方法，该方法内部调用文件对象的absolute属性时触发空指针异常。

排查步骤

检查compressAndGetFile的第二个参数是否合法：你当前传入的是img.path.split('/').last，仅为输出文件名，而该方法要求第二个参数是输出文件的完整存储路径，仅传文件名会导致写入路径无效，直接返回null。
检查应用权限与原文件有效性：压缩操作需要读取原文件、写入新文件，如果你未申请存储读写权限、原文件路径无效/已被删除，都会导致压缩失败返回null。
检查压缩参数适配性：如果原文件本身已经是高压缩率格式，或设置的压缩quality和原文件画质接近，部分版本的flutter_image_compress会因为压缩后体积无明显变化直接返回null。

修复方案

修正压缩方法的输出路径参数，借助path_provider生成合法的临时文件路径，示例代码如下：

import 'package:path_provider/path_provider.dart';
import 'package:path/path.dart' as Path;

// 先获取应用临时目录
final tempDir = await getTemporaryDirectory();
// 拼接生成完整的输出文件路径
final targetPath = '${tempDir.path}/${Path.basename(img.path)}';
// 调用压缩方法
File? compressed = await FlutterImageCompress.compressAndGetFile(
  img.path,
  targetPath,
  quality: 80,
);

增加空校验逻辑，压缩失败时降级处理：

final ref = firebase_storage.FirebaseStorage.instance
    .ref()
    .child('postimages/${Path.basename(img.path)}');

if (compressed != null) {
  await ref.putFile(compressed);
} else {
  // 压缩失败时直接使用原文件上传，也可以根据业务需求抛出错误提示用户
  await ref.putFile(img);
}