Firebase Cloud Functions部署失败：Cloud Build无日志显示

问题描述 #

通过firebase init functions创建模板项目，取消注释默认的helloWorld函数代码：

exports.helloWorld = onRequest((request, response) => {
  logger.info("Hello logs!", { structuredData: true });
  response.send("Hello from Firebase!");
});

执行firebase deploy --only functions命令部署时，构建直接失败，且Cloud Build控制台无任何日志输出。控制台错误提示如下：

Build failed with status: FAILURE and message: An unexpected error occurred. Refer to build logs: https://console.cloud.google.com/cloud-build/builds;region=us-central1/....
For more details see the logs at https://console.cloud.google.com/cloud-build/builds;region=us-central1/..
Functions deploy had errors with the following functions:
helloWorld(us-central1)
Error: There was an error deploying functions

账号已拥有Owner权限，权限层面无限制。

解决步骤 #

• 升级Firebase CLI版本：旧版本CLI可能存在兼容性问题，先执行firebase --version查看当前版本，若低于10.x，运行npm install -g firebase-tools升级到最新稳定版
• 本地预验证构建：如果是TypeScript项目，先在本地执行npm run build验证代码能否正常编译；JavaScript项目可直接检查package.json依赖是否完整，确保本地无语法或依赖错误
• 重置函数部署状态：执行firebase functions:delete helloWorld删除已创建的失败函数，重新执行firebase deploy --only functions尝试部署
• 启用Cloud Build API：手动进入Google Cloud控制台，搜索并启用Cloud Build API，部分情况下Owner权限也不会自动启用该API
• 获取详细部署日志：执行部署命令时添加--debug参数，即firebase deploy --only functions --debug，通过CLI输出的详细日志定位具体错误原因
• 确认区域一致性：检查项目的Cloud Build区域与Functions部署区域（us-central1）是否一致，避免跨区域部署导致的异常

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