Serverless部署报错：未识别stages和build配置项

1. 确认Serverless Framework版本 #

先运行命令查看当前使用的版本：

serverless --version

如果是从v2升级到v3，框架的配置结构发生了关键变更，根节点的stages和build属性已不再被官方识别。

2. 调整ESBuild配置层级 #

Serverless v3中ESBuild功能依赖serverless-esbuild插件实现，需将原根节点的build.esbuild配置迁移至custom.esbuild下，同时确保插件已安装：

安装依赖插件 #

npm install --save-dev serverless-esbuild

修改后的ESBuild配置示例 #

custom:
  esbuild:
    bundle: true
    minify: false
    external:
      - "uuid"
      - "pg"
      - "axios"
    exclude: "*"
    format: cjs

plugins:
  - serverless-esbuild

3. 修复stages配置问题 #

根节点的stages属性在v3中已废弃，需将账号相关配置迁移至provider节点：

provider:
  name: aws
  region: ${env:AWS_SERVERLESS_REGION}
  accessKeyId: ${env:AWS_SERVERLESS_ACCESS_KEY_ID}
  secretAccessKey: ${env:AWS_SERVERLESS_SECRET_ACCESS_KEY}

如果是依赖第三方插件的解析器功能，需查阅对应插件的最新文档，将配置移至custom节点下的插件专属配置区域。

4. 验证并部署 #

修改完成后，先运行命令检查配置合法性：

serverless print

确认无报错后，执行部署命令：

serverless deploy

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