sls deploy --stage dev部署时stage未添加到API端点问题排查

安全阿岳

2026-8-30

问题原因

代码中读取的process.env.RestApiId、process.env.REGION、process.env.stage三个环境变量，Serverless框架默认不会自动注入Lambda运行时，直接读取会拿到undefined或错误值
当前生成的API端点不带stage路径，通常是开启了API Gateway根路径映射、或使用HTTP API(v2)默认阶段映射到根路径导致，路径中不会自动追加/dev这类stage标识

修复方案

1. 修正serverless.yml配置

显式注入Lambda运行需要的环境变量，不要依赖框架默认注入的非标准命名变量，调整provider配置段如下：

service: lytoolsApi
frameworkVersion: '2 || 3'
configValidationMode: error
provider:
  name: aws
  runtime: nodejs12.x
  region: us-east-1
  stage: dev
  # 显式注入需要的环境变量
  environment:
    REST_API_ID: !Ref ApiGatewayRestApi
    REGION: ${aws:region}
    STAGE: ${self:provider.stage}

如果你之前配置了API Gateway自定义域名根路径映射、或者REST API根资源手动映射，需要确认最终生成的端点路径结构，不要硬套带stage的路径格式。

2. 调整Lambda中URL拼接逻辑

根据部署后实际生成的API端点格式，修改代码：

如果部署后端点格式就是不带stage的（如你现在看到的https://****.execute-api.us-east-1.amazonaws.com/users），去掉路径中的stage段：

postback_url = `https://${process.env.REST_API_ID}.execute-api.${
            process.env.REGION
        }.amazonaws.com/dfs-pingback?id=$id&tag=$tag`;

如果你需要保留stage路径前缀，确认使用的是REST API类型（事件配置为http:而非httpApi:），部署后默认端点会自动带stage段，此时拼接逻辑保留stage变量即可：

postback_url = `https://${process.env.REST_API_ID}.execute-api.${
            process.env.REGION
        }.amazonaws.com/${process.env.STAGE}/dfs-pingback?id=$id&tag=$tag`;