部署Google Cloud Functions时如何正确指定自定义入口点？

问题核心 #

你遇到的启动失败问题，本质是没有正确配置函数的入口文件与入口函数，导致Cloud Functions无法加载到目标函数，进而无法启动服务监听端口。

正确配置步骤 #

1. 确保函数文件导出正确 #

在 src/custom.js 中，需通过Cloud Functions Framework注册函数，代码结构如下（确保已安装 @google-cloud/functions-framework 依赖）：

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

// 注册HTTP函数，名称为helloHttp
functions.http('helloHttp', async (req, res) => {
    // 业务代码示例
    res.status(200).send('请求处理成功');
});

2. 部署时的正确命令 #

Cloud Functions 需要明确知道源代码位置和函数名称，有两种常用配置方式：

方式一：命令行指定源代码路径+入口函数

直接通过 --source 参数指向包含入口文件的目录，--entry-point 指定函数名称：

gcloud functions deploy function-1 \
  --source=./src \
  --entry-point=helloHttp \
  --runtime nodejs20 \
  --trigger-http \
  --project projectId

注：如果 src 目录下的入口文件不是默认的 index.js，需在 src 目录下创建 package.json，指定入口文件：

{
  "main": "custom.js"
}

方式二：根目录package.json配置

在项目根目录的 package.json 中添加启动脚本，指定入口文件和函数：

{
  "scripts": {
    "start": "functions-framework --target=helloHttp --source=./src/custom.js"
  },
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  }
}

之后部署命令可简化为：

gcloud functions deploy function-1 \
  --entry-point=helloHttp \
  --runtime nodejs20 \
  --trigger-http \
  --project projectId

之前错误的原因 #

• 第一种命令中 --entry-point=src/custom.js/helloHttp 格式错误：--entry-point 仅需函数名称，不需要文件路径。
• 第二种命令未指定源代码目录或入口文件，Cloud Functions 默认在根目录查找 index.js，无法找到你的 helloHttp 函数，导致服务启动失败。

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