部署带onDocumentCreated触发器的Cloud Functions V2时遇计费错误

部署Cloud Functions V2时出现错误：Write access to project 'xxxxx' was denied: please check billing account associated and retry，但V1版本可正常部署，核心原因是V2与V1的依赖组件、权限要求存在差异，以下是排查和解决步骤：

核心差异与可能原因 #

• Cloud Functions V2依赖Artifact Registry（存储函数镜像）和Cloud Build（构建镜像）服务，这些是V1不需要的基础组件，若相关API未启用或权限不足会触发写入权限错误。
• V2对计费账户状态的校验更严格，即使V1能正常部署，若计费账户存在欠费、暂停等异常，V2部署会直接失败。
• 部署账号缺少V2所需的特定权限，而V1的权限要求相对宽松，现有权限不足以支撑V2的部署流程。

解决方案 #

1. 检查计费账户状态
   登录GCP控制台进入「计费」页面，确认关联的计费账户处于活跃状态，无欠费、暂停或权限限制。

2. 启用必要API
   在GCP控制台的「API和服务」→「库」中，搜索并启用以下API：

   • Artifact Registry API
   • Cloud Build API

3. 验证部署账号权限
   确保用于部署的账号拥有以下权限（可通过IAM页面添加对应角色，比如Cloud Functions Developer + Artifact Registry Administrator + Cloud Build Editor的组合，或直接用Owner角色快速测试）：

   • cloudfunctions.functions.create
   • artifactregistry.repositories.create
   • cloudbuild.builds.create
   • iam.serviceAccounts.actAs

4. 更新部署工具
   若使用firebase CLI或gcloud CLI部署，确保工具为最新版本：

   # 更新firebase CLI
   npm install -g firebase-tools
   # 更新gcloud CLI
   gcloud components update
   

5. 重新配置项目（可选）
   若使用firebase CLI，执行以下命令重新初始化函数配置，确保明确选择V2版本：

   firebase init functions
   

用户提供的函数代码 #

const { onDocumentCreated } = require("firebase-functions/v2/firestore");
const { getMessaging } = require('firebase-admin/messaging');
const { initializeApp } = require('firebase-admin/app');

initializeApp();

exports.sendNotificationOnSales = onDocumentCreated('sales/{docId}', async (event) => {
  const newData = event.data.data();

  const itemName=newData['Item name'];
  const itemPrice=newData['Price'];

  const message = {
    topic: 'sale',
    notification: {
      title: 'New item for sale has been added',
      body: `${itemName} ${itemPrice}`,
    },
  };

  try {
    await getMessaging().send(message);
    console.log('Notification sent successfully');
  } catch (error) {
    console.error('Error sending notification:', error);
  }
});

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