GCP默认Cloud Build服务账户未在IAM中显示，无法授权致Cloud Function构建失败

核心原因 #

Cloud Build默认服务账号（{project number}@cloudbuild.gserviceaccount.com）会在启用Cloud Build API后自动生成，但偶尔会因控制台数据同步延迟，导致在IAM界面无法直接搜索到该账号。

解决步骤 #

1. 确认Cloud Build API已启用 #

若未启用该API，服务账号不会被创建。可通过两种方式启用：

• 命令行方式：

  gcloud services enable cloudbuild.googleapis.com
  

• 控制台方式：进入GCP控制台「API和服务」>「库」，搜索「Cloud Build API」并完成启用。

2. 手动添加服务账号到IAM #

即使IAM界面搜不到该账号，也可直接手动输入邮箱添加权限：

• 打开「IAM与管理员」>「IAM」页面
• 点击顶部「添加」按钮
• 在「新成员」输入框中准确填写完整的服务账号邮箱（{project number}@cloudbuild.gserviceaccount.com）
• 为账号分配对应角色：
  • 仅需创建Cloud Function时，选择「Cloud Functions Developer」角色
  • 需要完整部署权限时，可选择「Cloud Functions Admin」角色
• 点击「保存」完成权限配置

3. 验证服务账号存在性 #

用gcloud命令确认账号是否存在：

gcloud iam service-accounts list

若输出结果包含目标服务账号，说明账号确实存在，仅需手动添加权限即可生效。

4. 检查触发器的服务账号配置 #

进入Cloud Build触发器页面，编辑对应触发器，确认「服务账号」选项是否设置为默认的Cloud Build服务账号，避免因指定其他无权限账号导致构建失败。

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