GCP Cloud Functions Gen2迁移后触发GCS操作时出现'Cannot read properties of undefined (reading 'cloudStorageURI')'错误

我之前把Gen1云函数迁到Gen2的时候也踩过这个坑，这个错误大多和GCS客户端初始化不规范、环境配置没跟上Gen2的变化有关，咱们结合你的代码一步步解决：

1. 先修正GCS客户端的初始化逻辑 #

你现在手动指定projectId初始化Storage实例的方式在Gen2环境下容易出问题——Gen2托管在Cloud Run上，凭据是通过环境变量自动注入的，手动传参反而会干扰客户端加载完整配置。

优化方案二选一： #

• 方案A（推荐，复用Firebase Admin的实例）
  既然你已经初始化了Firebase Admin，直接用它提供的存储实例就行，不需要单独初始化@google-cloud/storage的Storage类：

  // 删掉你原来的const storage = new Storage({ projectId: projectId, });
  // 直接用admin的存储实例
  const bucket = admin.storage().bucket(bucketName);
  

  后面上传文件的代码改成：

  return bucket.upload(tempFilePath, {
    destination: fileName,
    resumable: false,
  });
  

• 方案B（如果一定要用@google-cloud/storage）
  不要传projectId参数，让客户端自动从环境获取配置：

  const storage = new Storage(); // 空参数，自动加载环境凭据和项目ID
  

2. 修正代码里的变量错误（这些小问题会间接导致异常干扰排查） #

看你的代码里有几个明显的变量问题，先改了避免其他错误：

• sitemapsId的赋值错误：

  // 原来的代码：
  const id = event.data.ref.path.split("/");
  const sitemapsId = id; // 这会把sitemapsId变成数组，后面doc(sitemapsId)会出错
  // 改成：
  const [_, sitemapsId] = event.data.ref.path.split("/"); // 解构取第二个元素
  

• items数组变量名混乱：
  你第一个then里定义的是itemsoptions数组，但push的时候用了items.push(doc.data())，这会导致ReferenceError: items is not defined，后面的逻辑全走不下去，修正成：

  querySnapshot.forEach((doc) => {
    itemsoptions.push(doc.data()); // 统一用itemsoptions
  });
  

  后面第二个then里的数组同理，改成const items = [];再执行push操作。

3. 确保Firebase Admin初始化正确 #

确认你的Admin初始化代码明确指定了存储桶（如果没写的话补上）：

const admin = require("firebase-admin");
admin.initializeApp({
  storageBucket: "abc-app.appspot.com" // 和你代码里的bucketName一致
});

这样admin.storage().bucket()会默认使用这个桶，后续操作更顺畅。

4. 检查Cloud Run服务账号的权限 #

Gen2的云函数用的是Cloud Run的服务账号，确保它有GCS的写入权限：

• 找到你的云函数对应的Cloud Run服务（在Cloud Run控制台找和函数同名的服务）
• 查看它使用的服务账号（一般是PROJECT_ID@appspot.gserviceaccount.com）
• 给这个账号添加Storage Object Creator或Storage Object Editor角色（在IAM控制台配置）

把这些改完之后，再部署测试应该就能解决cloudStorageURI未定义的问题了，本质上是GCS客户端没拿到正确的配置，导致内部属性访问失败。

内容来源于stack exchange