如何为Firebase Storage上传文件附加自定义数据？

你上传文件时设置自定义元数据的代码是正确的，问题出在云函数触发器里获取元数据的方式上。下面是具体的解决方案和排查步骤：

1. 云函数中获取自定义元数据的正确方式 #

在onChange触发器的事件对象中，已经包含了文件的元数据，不需要额外调用file.getMetadata()（当然调用也能拿到，但直接从事件对象获取更高效）。正确的获取方式如下：

export const processUploadedFile = functions.storage.object().onChange((event) => {
  // 获取文件的元数据
  const metadata = event.data.metadata;
  // 获取自定义元数据
  const customMetadata = metadata.customMetadata;
  
  if (customMetadata) {
    console.log('自定义元数据:', customMetadata);
    console.log('Test字段的值:', customMetadata.Test);
    // 这里写你的后续处理逻辑，比如提取文件、移动目录等
  } else {
    console.log('未找到自定义元数据');
  }
  
  return Promise.resolve();
});

如果确实需要调用getMetadata()，注意旧版本SDK返回的是包含元数据对象的数组，正确写法应该是：

// 从事件对象中获取文件引用
const file = event.data;
file.getMetadata().then((metaData) => {
  // 兼容新旧SDK的返回格式
  const actualMetadata = Array.isArray(metaData) ? metaData[0] : metaData;
  console.log('自定义元数据:', actualMetadata.customMetadata);
});

2. 确认上传时的元数据设置无误 #

你的上传代码逻辑没问题，可以补充一段验证代码，确认元数据是否成功附加到文件上：

fileRef.put(file, newMetadata)
  .then((snapshot) => {
    console.log('上传完成');
    // 上传后立即获取元数据，验证是否设置成功
    return snapshot.ref.getMetadata();
  })
  .then((metadata) => {
    console.log('上传后的自定义元数据:', metadata.customMetadata);
  })
  .catch((error) => {
    console.error('上传错误:', error);
  });

3. 排查其他可能的问题 #

• 检查Firebase CLI版本，确保是最新版，避免SDK版本兼容问题
• 重新部署云函数，确保代码更新生效
• 登录Firebase控制台，查看Storage中已上传文件的详情，在「元数据」标签页确认自定义元数据是否存在

通过以上步骤，你应该能在触发器函数中正确获取到自定义元数据，进而实现后续的处理逻辑。

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