Firebase Cloud Storage上传元数据后云函数无法读取如何解决

服务端读不到自定义元数据有两个直接原因：

1. 客户端上传时元数据传参格式不符合Firebase SDK要求：你把自定义字段直接塞到了metadata属性下，SDK不会识别这部分内容，上传时会直接忽略，自然不会写入文件元数据。
2. 服务端调用getMetadata()的取值方式错误：该API返回的是数组结构，第一个元素才是真正的元数据对象，直接拿返回结果访问metadata属性必然得到undefined。

1. 修正客户端上传代码 #

Firebase JS SDK 上传文件时，自定义元数据必须放在customMetadata字段下，把原来的上传参数部分替换成如下写法：

// 元数据格式修正
const fileMetadata = {
  customMetadata: {
    project_id: my_project_id
  }
};
// 直接把元数据对象作为put的第二个参数，不要额外套metadata层
const uploadTask = myRef.put(file, fileMetadata);

你原来写的{ metadata: metadata }属于SDK不识别的冗余参数，不会产生任何效果。

2. 优化服务端元数据读取逻辑 #

你完全不需要额外调用getMetadata()拉取元数据，存储触发器回调传入的object参数已经自带了文件的全量元数据，自定义字段直接从object.metadata上取即可，参考代码：

exports.uploadHandler = functions.storage.object().onFinalize(async (object) => { 
  // 兜底空对象，避免文件无自定义元数据时报错
  const customMetadata = object.metadata || {};
  const projectId = customMetadata.project_id;
  console.log("获取到的关联项目ID：", projectId);

  // 后续基于元数据的业务处理逻辑写在这里

  return;
});

• 自定义元数据的所有值上传后都会被自动转为字符串，如果你传了数字、布尔类型的值，服务端读取后要手动做类型转换
• 修改完客户端代码后，要上传新文件测试，之前已经上传成功的旧文件不会自动补充元数据
• 不要在自定义元数据里存放敏感信息，只要文件有公开读权限，元数据也会对外公开

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