如何复用Serverless Framework包制品实现AWS Lambda多环境部署？

核心思路 #

通过分离Lambda代码打包与环境专属基础设施模板生成，实现一次代码构建复用所有环境，既符合单一不可变包原则，又避免重复打包浪费CI时间。

具体操作步骤 #

1. 预构建通用Lambda代码包

先完成一次完整的代码构建（比如编译TS、安装生产依赖），然后打包成独立的zip文件，这个包是所有环境共用的：

# 示例：根据你的项目调整构建命令
npm run build
# 将代码和依赖打包为通用 artifact
zip -r lambda-shared-artifact.zip dist/ node_modules/

2. 配置Serverless复用预构建包

在serverless.yml中指定package.artifact指向刚才生成的通用包，这样后续执行sls package时会跳过代码打包流程，仅生成环境专属的基础设施配置：

service: my-aws-lambda-service

package:
  artifact: ./lambda-shared-artifact.zip # 复用预构建的通用代码包

provider:
  name: aws
  runtime: nodejs18.x
  stage: ${opt:stage, 'dev'}
  region: us-east-1
  # 环境变量等配置通过stage动态区分
  environment:
    APP_ENV: ${self:provider.stage}

functions:
  mainHandler:
    handler: dist/handler.main

3. 生成各环境专属部署包

分别为测试、生产环境执行sls package，此时只会生成对应环境的CloudFormation模板、状态文件等，不会重复打包代码：

# 生成测试环境部署包，输出到指定目录
sls package --stage test --package .serverless-test

# 生成生产环境部署包，输出到指定目录
sls package --stage prod --package .serverless-prod

4. 部署到对应环境

使用各自的环境专属包执行部署：

# 部署至测试环境
sls deploy --package .serverless-test

# 部署至生产环境
sls deploy --package .serverless-prod

额外优化（Serverless v3+）

开启package.cache可以进一步加快后续sls package的执行速度，避免重复处理相同的代码文件：

package:
  artifact: ./lambda-shared-artifact.zip
  cache: true

原方案失败原因 #

sls package生成的.serverless目录中，serverless-state.json和cloudformation-template-update-stack.json等文件包含环境专属的资源配置（比如带stage前缀的资源名称、权限策略、环境变量映射等），直接复用同一个包跨环境部署会导致资源命名冲突、配置不匹配等问题。

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