Flutter Web开发：如何在Firebase Storage中获取last_access_time？

首先明确两个核心点：

• Firebase Storage 没有原生支持自动删除长时间未访问文件的功能；
• Storage 文件元数据中确实不提供last_access_time字段，仅能获取timeCreated和updated。

要实现需求，需要手动追踪文件访问时间并构建清理逻辑，以下是可行方案：

1. 手动追踪文件访问时间 #

需要在文件被访问时，主动更新其自定义元数据来记录访问时间，分两种场景处理：

场景1：通过Flutter客户端触发访问（比如APP内下载/预览） #

每次用户在APP内访问文件时，调用Storage的updateMetadata方法，添加自定义字段lastAccessed存储当前时间戳：

// 获取文件引用
final fileRef = FirebaseStorage.instance.ref('your/file/path');

// 更新自定义元数据，记录访问时间
await fileRef.updateMetadata(
  SettableMetadata(
    customMetadata: {
      'lastAccessed': DateTime.now().millisecondsSinceEpoch.toString(),
    },
  ),
);

场景2：用户直接通过Storage公开URL访问 #

如果文件是公开可访问的（比如直接打开链接下载），客户端代码无法触发更新，此时需要用Cloud Functions监听Storage的下载事件，在云端自动更新元数据：

// Cloud Functions 代码（Node.js）
const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.trackFileAccess = functions.storage.object().onFinalize(async (object) => {
  const file = admin.storage().bucket(object.bucket).file(object.name);
  // 获取当前文件元数据
  const [metadata] = await file.getMetadata();
  // 更新lastAccessed字段为当前时间戳
  await file.setMetadata({
    metadata: {
      ...metadata.metadata,
      lastAccessed: Date.now().toString(),
    },
  });
});

2. 定期清理过期文件 #

通过Cloud Functions的定时触发器，定期扫描所有文件，根据自定义的lastAccessed字段判断是否超过阈值，执行删除操作：

// Cloud Functions 定时清理任务
exports.cleanupUnaccessedFiles = functions.pubsub.schedule('every 24 hours').onRun(async (context) => {
  const bucket = admin.storage().bucket();
  const [files] = await bucket.getFiles();
  // 设置过期阈值：比如30天未访问
  const cutoffTimestamp = Date.now() - 30 * 24 * 60 * 60 * 1000;

  const deleteTasks = [];
  for (const file of files) {
    const [metadata] = await file.getMetadata();
    const lastAccessed = metadata.metadata?.lastAccessed;
    
    // 跳过未记录访问时间的文件，或未过期的文件
    if (!lastAccessed || parseInt(lastAccessed) >= cutoffTimestamp) continue;
    
    deleteTasks.push(file.delete());
  }

  await Promise.all(deleteTasks);
  functions.logger.info(`已删除${deleteTasks.length}个过期文件`);
  return null;
});

注意事项 #

• 自定义元数据有1KB大小限制，存储时间戳完全满足需求；
• 确保Cloud Functions拥有Storage的读取、修改元数据、删除文件的权限；
• 若文件存在大量公开访问（如爬虫抓取），上述方案可能无法精准追踪所有访问，此时需要结合Cloud Storage访问日志分析，复杂度会更高。

内容的提问来源于stack exchange，提问作者Ayad Salim