如何基于Serverless部署Lambda时按环境条件配置provisioned concurrency?
按环境配置Lambda预置并发的落地实现
旧方案踩坑根因
- 第一版方案失效逻辑:
你将需要生效的provisionedConcurrency配置写进了函数级的custom字段。custom是Serverless预留的自定义配置存储区,不会被识别为正式的Lambda部署配置项,哪怕导入了外部yml的内容,也不会触发CloudFormation预置并发资源的生成。另外顶层编写的isProdOrUAT条件本身存在结构问题:{"${opt:stage}": "prod"}这种写法不是合法的CloudFormation条件语法,因为编译期变量opt:stage会在模板解析前被替换成具体字符串,最终生成的Conditions对象根本不是合法的Fn::Or结构。 - 第二版方案报空值的逻辑:
Serverless Framework 2.22版本对provisionedConcurrency字段的处理逻辑是:只要检测到函数配置中存在这个键,不管实际值是什么,都会自动生成对应的Lambda别名、ProvisionedConcurrencyConfig类资源。哪怕你在值的位置通过!If条件传入了AWS::NoValue,Serverless也不会给生成的预置并发资源绑定对应的Condition属性控制是否创建,只会硬把解析出的null值填充到生成的CloudFormation模板的ProvisionedConcurrentExecutions参数里,触发CloudFormation的空值校验报错。
适配当前版本的正确配置写法
核心思路是把环境判断逻辑放到Serverless的编译期变量解析阶段,不依赖CloudFormation的运行期条件判断,从根源上避免非目标环境出现provisionedConcurrency字段,进而防止无效资源生成:
- 在
custom块中定义编译期的环境判断逻辑,直接根据传入的--stage参数判断是否属于prod/uat环境 - 在函数配置中通过Serverless内置的条件变量语法,仅当环境符合要求时才注入
provisionedConcurrency字段,dev/test环境直接完全移除该字段,避免Serverless生成无效的预置并发资源
参考配置如下:
provider: name: aws runtime: java11 stage: dev # 默认部署阶段 custom: # 编译期判断当前部署阶段是否为prod/uat isProdOrUAT: ${matches(${opt:stage, self:provider.stage}, /^(prod|uat)$/)} functions: TestApi: handler: test.api.StreamLambdaHandler::handleRequest description: Lambda function for the Test API timeout: 20 # 仅当判断为prod/uat时,才注入provisionedConcurrency配置 ${if(custom.isProdOrUAT, "provisionedConcurrency: ${ssm:/${opt:stage}/TestsServiceProvisionedConcurrency}")}
CodeBuild部署适配说明
这套判断逻辑完全由Serverless在本地编译阶段完成,你只需要在CodeBuild的部署步骤中,按环境传入正确的--stage参数(例如部署UAT时执行serverless deploy --stage uat,部署prod时执行serverless deploy --stage prod,dev/test环境执行对应stage的deploy命令即可),不需要额外在CodeBuild脚本中编写条件分支逻辑。
最终实现效果:
- dev/test环境下,函数配置中完全不存在
provisionedConcurrency字段,Serverless不会生成对应的预置并发资源,无空值报错 - UAT/prod环境下,正常从SSM参数中读取对应环境的预置并发值,生成的CloudFormation资源可以正确配置Lambda的预置并发
内容的提问来源于stack exchange,提问作者Sidharth Shashikar
相关产品推荐
相关产品推荐

