GCP Cloud Functions Gen2调用异常：Node.js与gcloud均失败

背景 #

在GCP项目「project-x」中创建了默认配置的Gen2 Cloud Function，设置为「Allow unauthenticated」权限，代码如下：

const functions = require('@google-cloud/functions-framework');

functions.http('helloHttp', (req, res) => {
 res.send(`Hello ${req.query.name || req.body.name || 'World'}!`);
});

直接通过生成的函数URL（如https://my-function-bvskvwq11c-uc.a.run.app）访问可正常返回响应，但遇到以下两个问题：

• A. 使用npm包@google-cloud/functions调用时，返回含陌生项目ID的权限拒绝错误，列出函数为空列表；
• B. 使用gcloud工具可正常列出函数，但调用命令返回404错误，提示函数不存在。

问题A：@google-cloud/functions 包调用异常 #

原因 #

1. @google-cloud/functions SDK仅针对Gen1 Cloud Functions设计，对Gen2函数兼容性极差，会尝试调用旧版API端点，无法识别Gen2资源，进而出现权限错误或空列表。
2. 本地认证环境可能未关联目标项目「project-x」，比如gcloud默认项目配置错误，或应用默认凭据指向其他项目。

解决办法 #

1. 推荐方案：直接使用HTTP请求库（如axios、node-fetch）调用函数URL，Gen2函数本质是HTTP服务，无需专用SDK即可调用：

   const fetch = require('node-fetch');
   (async () => {
     const response = await fetch('https://my-function-bvskvwq11c-uc.a.run.app');
     console.log(await response.text());
   })();
   

2. 若需使用官方工具，改用@google-cloud/run包（Gen2函数基于Cloud Run构建），同时确保本地认证配置正确：
   • 执行 gcloud config set project project-x 设置默认项目
   • 执行 gcloud auth application-default login 刷新应用默认凭据

问题B：gcloud工具调用返回404 #

原因 #

Gen2与Gen1的gcloud调用命令格式不同，若使用Gen1的命令调用Gen2函数，gcloud会在错误的资源路径下查找，导致404。

解决办法 #

使用Gen2专用的调用命令，必须指定--gen2参数和函数所在区域：

gcloud functions call helloHttp --gen2 --region=us-central1

注意：替换us-central1为你实际创建函数时选择的区域，若未指定区域，可通过 gcloud functions list --gen2 查看函数的区域信息。

内容的提问来源于stack exchange，提问作者m.spyratos