第二代Cloud Function部署成功但无法触发的问题求助

问题背景 #

按官方教程部署第二代Cloud Function，绑定Cloud Storage object.v1.finalized触发器后，上传文件至指定存储桶，函数未触发且无日志记录。已确认：

• 代码符合官方示例（见下方）
• 部署命令参数配置正确
• 存储桶与函数处于同一区域
• 已为Eventarc使用的默认计算服务账号（xxx-compute@developer.gserviceaccount.com）添加Editor及Eventarc Connection Publisher角色

已部署代码 #

'use strict';

// [START functions_cloudevent_storage]
const functions = require('@google-cloud/functions-framework');

// Register a CloudEvent callback with the Functions Framework that will
// be triggered by Cloud Storage.
functions.cloudEvent('imageAdded', cloudEvent => {
  console.log(`Event ID: ${cloudEvent.id}`);
  console.log(`Event Type: ${cloudEvent.type}`);

  const file = cloudEvent.data;
  console.log(`Bucket: ${file.bucket}`);
  console.log(`File: ${file.name}`);
  console.log(`Metageneration: ${file.metageneration}`);
  console.log(`Created: ${file.timeCreated}`);
  console.log(`Updated: ${file.updated}`);
});
// [END functions_cloudevent_storage]

部署命令 #

gcloud functions deploy xxx-image-handler --gen2 --runtime=nodejs16 --project myproject --region=europe-west3 --source=. --entry-point=imageAdded --trigger-event-filters='type=google.cloud.storage.object.v1.finalized' --trigger-event-filters='bucket=xxx_report_images'

排查与解决步骤 #

1. 验证Eventarc触发器配置正确性 #

用命令查看当前函数的触发器详情，确认事件过滤条件与预期一致：

gcloud functions describe xxx-image-handler --gen2 --project myproject --region=europe-west3

检查输出中eventTrigger.eventFilters下的type和bucket值，确保和部署命令中的配置完全匹配。

2. 配置存储桶的Eventarc事件发送权限 #

Eventarc服务账号需要具备存储桶的对象查看权限才能接收事件，执行以下步骤：

1. 获取项目编号：

   gcloud projects describe myproject --format='value(projectNumber)'
   

2. 为Eventarc服务账号绑定存储桶权限：

   gsutil iam ch serviceAccount:service-${PROJECT_NUMBER}@gcp-sa-eventarc.iam.gserviceaccount.com:roles/storage.objectViewer gs://xxx_report_images
   

   替换${PROJECT_NUMBER}为上一步获取的项目编号。

3. 确认函数入口点与代码注册名严格匹配 #

Node.js环境对大小写敏感，部署命令中的--entry-point=imageAdded必须和代码中functions.cloudEvent('imageAdded', ...)的第一个参数完全一致，包括大小写。

4. 检查Eventarc API是否已启用 #

执行命令确认Eventarc API状态：

gcloud services list --enabled | grep eventarc.googleapis.com

若未启用，执行启用命令：

gcloud services enable eventarc.googleapis.com

5. 确认存储桶与函数区域完全一致 #

第二代Cloud Function的Eventarc触发器要求存储桶和函数处于同一GCP区域，查看存储桶区域：

gsutil ls -L gs://xxx_report_images | grep Location

确保输出区域为europe-west3，与函数部署区域一致。

6. 重新部署函数 #

若以上配置均正确，尝试重新部署函数以重置触发器配置：

gcloud functions deploy xxx-image-handler --gen2 --runtime=nodejs16 --project myproject --region=europe-west3 --source=. --entry-point=imageAdded --trigger-event-filters='type=google.cloud.storage.object.v1.finalized' --trigger-event-filters='bucket=xxx_report_images'

验证方法 #

重新上传文件后，通过以下命令查看函数日志：

gcloud functions logs read xxx-image-handler --gen2 --region=europe-west3 --project myproject

若触发器生效，日志中会出现代码中打印的事件信息。

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