Flutter使用Firebase图片缩放扩展获取缩放图时遇对象不存在错误

核心问题排查与修复方案 #

1. 路径匹配错误（最常见原因）

你当前仅提取了原图片的文件名（不含路径），但如果原图片是上传到存储桶的子目录下（比如user_photos/avatar.png），缩放后的图片会保存在同一个子目录中，而非存储桶根目录。你现在的代码会去根目录找avatar_200x200.jpeg，但实际文件在user_photos/avatar_200x200.jpeg，自然触发"对象不存在"错误。

修复代码：保留原图片的目录路径，仅替换文件名部分

Future<String> uploadResizedData(String image, Uint8List data) async {
  final storage = FirebaseStorage.instanceFor(bucket: 'resized');
  final storageRef = storage.ref().child(image);
  final metadata = SettableMetadata(contentType: mime(image));
  final result = await storageRef.putData(data, metadata);

  if (result.state == TaskState.success) {
    // 拆分原图片的目录和文件名
    final imageDir = path.dirname(image);
    final imageName = path.basenameWithoutExtension(image);
    // 拼接完整的缩放图片路径（包含原目录）
    final resizedImagePath = path.join(imageDir, '${imageName}_200x200.jpeg');
    
    final resizedImageRef = storage.ref(resizedImagePath);
    // 加入重试逻辑处理延迟
    int retryCount = 0;
    while (retryCount < 3) {
      try {
        final resizedImageDownloadURL = await resizedImageRef.getDownloadURL();
        return resizedImageDownloadURL;
      } catch (e) {
        retryCount++;
        await Future.delayed(const Duration(seconds: 1));
      }
    }
  }
  return null;
}

2. 扩展处理存在延迟

上传图片成功后，Firebase扩展需要几秒时间完成图片缩放生成。你在上传成功后立即请求下载URL，此时扩展可能还未完成处理，导致对象暂时不存在。

优化方案：

• 加入短暂重试逻辑（如代码示例中3次重试，每次间隔1秒）
• 若需更可靠的触发方式，可配置Cloud Functions监听扩展完成事件，当图片生成后主动通知客户端再获取URL

3. 验证实际存储路径

登录Firebase控制台的Storage面板，找到缩放后的图片，复制它的完整存储路径，与你代码中构建的resizedImagePath对比，重点检查：

• 目录层级是否一致
• 文件名大小写、特殊字符是否匹配
• 扩展名是否与扩展配置的输出格式一致（比如是否是.jpeg而非.jpg）

4. 检查扩展配置

确认你安装的Storage图片缩放扩展配置项：

• 目标尺寸是否设置为200x200
• 输出格式是否为JPEG
• 是否修改了默认的路径模板（默认会将缩放图保存在原文件同一目录）

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