如何在Flutter安卓应用中使用Firebase Firestore存储图片

首先明确：Firebase Firestore 是轻量结构化文档数据库，单文档最大容量仅1MB，不推荐直接存储完整图片二进制数据，常规可采用以下两种方案实现：

方案1：配合Cloud Storage存储（官方推荐方案） #

该方案是生产环境的标准实现，性能、成本、可维护性都最优：

• 第一步：在Firebase控制台开通Cloud Storage服务，配置符合业务要求的读写安全规则
• 第二步：Flutter端先将本地图片文件上传到Cloud Storage，获取图片的永久下载URL
• 第三步：将图片URL作为普通字符串字段，存入Firestore对应的业务文档中，后续需要展示图片时直接通过URL加载即可
  核心实现代码参考：

import 'package:firebase_storage/firebase_storage.dart';
import 'package:cloud_firestore/cloud_firestore.dart';
import 'dart:io';

Future<void> saveImageToFirestore(File imageFile, String docId) async {
  // 1. 上传图片到Cloud Storage
  final storageRef = FirebaseStorage.instance.ref().child("images/${DateTime.now().millisecondsSinceEpoch}.jpg");
  final uploadResult = await storageRef.putFile(imageFile);
  final imageUrl = await uploadResult.ref.getDownloadURL();
  
  // 2. 将图片URL存入Firestore
  await FirebaseFirestore.instance.collection("your_collection").doc(docId).update({
    "image_url": imageUrl
  });
}

方案2：Base64编码后直接存入Firestore（仅适用于极小图片） #

如果你的图片体积非常小（比如100KB以内的小图标、缩略图），可以转成Base64字符串直接存在Firestore字段中，该方案无需额外开通Cloud Storage，但缺陷非常明显：会大幅增加文档体积、加载时需要额外解码，图片体积超过1MB就会写入失败，非必要不推荐使用。
核心实现代码参考：

import 'dart:convert';
import 'package:cloud_firestore/cloud_firestore.dart';
import 'dart:io';

Future<void> saveSmallImageToFirestore(File tinyImageFile, String docId) async {
  // 图片转Base64编码
  final imageBytes = await tinyImageFile.readAsBytes();
  final base64Image = base64Encode(imageBytes);
  
  // 直接存入Firestore
  await FirebaseFirestore.instance.collection("your_collection").doc(docId).set({
    "tiny_thumbnail": base64Image
  }, SetOptions(merge: true));
}

// 读取时解码展示
Image.memory(base64Decode(base64ImageString));

注意：Firestore单文档最大容量为1MB，Base64编码会使数据体积膨胀约33%，请严格控制采用该方案存储的图片大小，避免写入失败。

内容的提问来源于stack exchange，提问作者George Jonathan Osafo-Osei