本地运行Serverless Lambda集成模式的配置问题求助

安全阿岳

2026-7-13

Serverless Offline Lambda集成模式问题修复

本地返回完整Lambda响应结构的解决方法

serverless-offline默认不会自动套用API Gateway的响应模板到本地请求，需手动开启模板解析：

在serverless.yml的自定义配置中添加以下内容，开启响应模板支持：

custom:
  serverless-offline:
    apiGateway:
      responseTemplates: true

同时确保你的API Gateway集成响应模板配置正确，指定直接返回Lambda输出的body内容：

functions:
  [你的函数名]:
    handler: handler.main
    events:
      - http:
          path: /[你的路径]
          method: get
          integration: lambda
          response:
            headers:
              Content-Type: "'application/json'"
            template: $input.path('$')
            statusCodes:
              200:
                pattern: ''

GET请求Query参数未传递的解决方法

Lambda集成模式下，serverless-offline不会自动把Query参数注入Lambda事件，需通过请求模板明确映射：

在http事件的request.template中添加Query参数的映射规则，示例：

request:
  template:
    application/json: |
      #set($queryStr = $input.params().querystring)
      {
        "queryStringParameters": $util.parseJson("{\"$queryStr\"}".replace("=", "\":\"").replace("&", "\",\""))
      }