GCP Cloud Function(Node.js) ZIP部署失败：function.js不存在

一、正确的ZIP包目录结构 #

核心坑点：ZIP根目录必须直接包含入口文件，不能嵌套子目录。多数错误源于将文件放入src/或其他子文件夹后打包，导致Cloud Build无法定位核心文件。标准结构如下：

your-function.zip
├── index.js       # 函数入口文件
├── package.json   # 配置与依赖文件
└── your-image.png # 你的PNG资源文件

二、package.json必填配置 #

必须明确指定主文件，覆盖构建系统的默认查找逻辑：

{
  "name": "my-cloud-function",
  "version": "1.0.0",
  "main": "index.js", // 强制指定入口文件
  "dependencies": {
    // 按需添加依赖，比如@google-cloud/storage等
  }
}

若使用Gen2，可额外添加"scripts": {"start": "node index.js"}，非强制但能提升兼容性。

三、部署命令的关键参数 #

无论Gen1还是Gen2，部署时必须显式指定函数导出名称，避免匹配错误：

Gen1部署命令示例 #

gcloud functions deploy myFunction \
  --runtime nodejs20 \
  --trigger-http \
  --entry-point myExportedFunction \
  --source gs://your-bucket/your-function.zip

Gen2部署命令示例 #

gcloud functions deploy myFunction \
  --gen2 \
  --runtime nodejs20 \
  --trigger-http \
  --entry-point myExportedFunction \
  --source gs://your-bucket/your-function.zip

其中myExportedFunction是你在index.js中导出的函数名，示例代码：

// index.js
exports.myExportedFunction = (req, res) => {
  // 函数逻辑，比如读取PNG文件
  res.status(200).send('Success');
};

四、打包与排查技巧 #

• 正确打包方式：进入文件所在目录后执行打包命令，确保根目录正确：

  cd /path/to/your-function-files
  zip -r your-function.zip .
  

  禁止打包整个子文件夹（如zip -r your-function.zip ./src）。
• 排除干扰文件：打包时排除隐藏文件和本地依赖目录，避免构建异常：

  zip -r your-function.zip . -x ".*" -x "node_modules/*"
  

• 大小写检查：GCP构建系统大小写敏感，确保index.js、package.json文件名完全小写，不要出现Index.js这类错误。
• 依赖验证：本地执行npm install确认依赖能正常安装，依赖安装失败会间接触发"function.js不存在"的错误提示。

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