使用根目录与函数级serverless.yml构建Serverless项目遇部署错误

错误原因 #

1. 配置结构不匹配：根目录serverless.yml用数组形式（- ${file(...)}）导入函数配置，但子文件里是postEvent: {...}的键值对结构，导致导入后functions数组的元素是一个包含函数名的嵌套对象，而非Serverless框架期望的单个函数配置对象，触发解析错误。
2. 变量引用失效：子文件中的${self:service}和${self:provider.stage}指向的是子文件自身的配置，但子文件未定义这些字段，导致变量无法解析。

解决方法 #

方案1：对象形式合并函数配置（推荐） #

这种方式保持每个子文件独立定义函数名和配置，直接合并到根目录的functions对象中：

根目录serverless.yml修改：

functions:
  ${file(./service/post_event/serverless.yml)}

子文件service/post_event/serverless.yml修改：

修正变量引用路径，确保指向根文件的配置，同时修正module路径与文件夹对应：

postEvent:
  name: ${file(../../serverless.yml):service}-${opt:stage, ${file(../../serverless.yml):provider.stage}}-postEvent
  handler: service.post_event.main.handler
  module: service/post_event

方案2：数组形式导入单个函数配置 #

如果偏好数组形式管理函数，子文件需直接导出单个函数的配置（去掉外层函数名键）：

根目录serverless.yml保持：

functions:
  - ${file(./service/post_event/serverless.yml)}

子文件service/post_event/serverless.yml修改：

name: ${file(../../serverless.yml):service}-${opt:stage, ${file(../../serverless.yml):provider.stage}}-postEvent
handler: service.post_event.main.handler
module: service/post_event

优化变量引用（可选） #

为了避免重复写${file(../../serverless.yml):...}，可以在根目录serverless.yml中定义自定义变量：

custom:
  serviceName: ${self:service}
  defaultStage: ${opt:stage, self:provider.stage}

然后子文件中直接引用：

postEvent:
  name: ${file(../../serverless.yml):custom.serviceName}-${file(../../serverless.yml):custom.defaultStage}-postEvent
  handler: service.post_event.main.handler
  module: service/post_event

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