AWS Serverless Framework v3配置HTTP API Gateway Stage失败求助

核心配置要点 #

HTTP API的Stage配置需放在provider.httpApi块下，而非直接在provider根节点或函数的httpApi事件中，以下是具体方案：

1. 全局自定义Stage（推荐） #

在provider段的httpApi配置中指定stageName，这会为整个HTTP API创建并绑定自定义Stage：

provider:
  name: aws
  region: eu-west-1
  runtime: python3.9
  httpApi:
    stageName: dev  # 自定义Stage名称
    cors: true  # 可选：全局CORS配置

2. 完整示例配置 #

包含Lambda函数与HTTP API绑定的完整serverless.yml：

service: ci-test-result-service

provider:
  name: aws
  region: eu-west-1
  runtime: python3.9
  httpApi:
    stageName: dev
    cors: true

functions:
  getResults:
    handler: lambda.handler
    name: ci-test-result-lambda
    events:
      - httpApi:
          path: /results
          method: GET

3. 命令行动态指定Stage #

若需部署多个不同Stage（如dev/prod），无需在配置文件硬编码，直接通过deploy命令指定：

serverless deploy --stage dev
# 或
serverless deploy --stage prod

执行后会自动创建对应名称的Stage，API访问路径格式为https://<api-id>.execute-api.eu-west-1.amazonaws.com/<stage-name>/results

你之前的配置错误说明 #

• 尝试2：直接在provider根节点设置stageName是REST API的配置逻辑，不适用于HTTP API，因此无效。
• 尝试3：HTTP API的events.httpApi配置中不存在stage或stageName字段，该字段仅用于REST API的events.http配置。

额外注意 #

确保你的Serverless Framework版本为v3及以上，旧版本对HTTP API的Stage支持存在兼容性问题，可通过serverless --version查看版本，如需更新执行npm install -g serverless。

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