使用Terraform部署Google Cloud Function时npm包依赖加载失败问题

问题1解决方案：正确打包包含package.json的归档文件 #

你遇到的打包范围问题可以通过以下任意一种方式解决：

1. 调整archive_file配置增加排除规则
   将source_dir指向项目根目录，通过excludes参数过滤不需要打包的内容，避免读取到被锁定的terraform状态文件：

data "archive_file" "source" {
  type        = "zip"
  source_dir  = "../"
  output_path = "/tmp/function-${local.timestamp}.zip"
  excludes = [
    "terraform/**",
    ".git/**",
    ".gitignore",
    "*.md"
    # 可自行添加其他不需要打包的文件/目录规则
  ]
}

2. 调整项目结构
   把根目录的package.json、package-lock.json移动到src目录下，保持原来的source_dir = "../src"配置不变即可，打包时会自动包含依赖声明文件。
3. 新增本地构建步骤
   提前把src/index.js、package.json、package-lock.json复制到一个临时的构建目录（比如dist），再把source_dir指向这个临时目录，打包逻辑更干净可控。

问题2：是否需要打包node_modules目录 #

默认不需要打包node_modules。GCP Cloud Function的Node.js运行环境会自动识别zip包根目录下的package.json，执行npm install --production自动安装生产依赖，你只需要把package.json和对应的lock文件（package-lock.json/yarn.lock）放到归档包中即可。
如果你的依赖包含需要编译的原生二进制组件，推荐在和GCP Cloud Function运行环境兼容的环境（对应Node版本的Linux环境、官方buildpack）提前编译好node_modules一起打包，避免运行时出现兼容性问题。打包前建议执行npm install --production剔除开发依赖，减少包体积。

问题3：切换GCP backend是否能解决state锁定报错 #

可以解决。使用GCS远程backend后，Terraform状态文件会存储在GCP存储桶中，本地不会生成terraform.tfstate文件，归档遍历目录时自然不会读取到被锁定的状态文件。
不过该问题的根因是打包范围包含了terraform目录，即使保留本地backend，只要按照问题1的方案添加排除规则也能解决该问题。切换为GCS backend是生产环境的推荐做法，还能额外支持团队协作、状态版本回溯、状态加密等能力。

补充优化建议：你当前用local.timestamp作为归档文件名的一部分，每次执行apply都会重新打包上传函数，建议改用文件哈希作为标识，只有源码/依赖变化时才重新部署，减少不必要的更新。

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