如何在AWS API Gateway中禁用查询参数解析以传递GraphQL查询？

我明白你遇到的痛点——本地用SAM Local测试好好的，一部署到API Gateway就返回400空响应，根源就是API Gateway默认会把查询参数里的GraphQL语句当成JSON去解析，可GraphQL语法压根不是标准JSON，自然就解析失败了。针对GET请求的场景，咱们可以通过修改CloudFormation/SAM模板来解决，具体步骤如下：

方案一：使用代理集成（AWS_PROXY）传递完整请求参数 #

SAM的Api事件默认其实就是代理集成，但有时候明确配置能确保API Gateway把完整的请求上下文（包括未被解析的query参数）原封不动传给Lambda：

修改你的模板中MyTimeApi事件部分，明确指定集成类型为AWS_PROXY：

Events:
  MyTimeApi:
    Type: Api
    Properties:
      Path: /ScheduleResource
      Method: GET
      Integration:
        Type: AWS_PROXY

之后在你的Lambda代码里，直接从event.queryStringParameters.query获取原始的GraphQL查询字符串即可，比如：

exports.handler = async (event) => {
  const graphqlQuery = event.queryStringParameters.query;
  // 后续处理GraphQL查询的逻辑
};

这种方式最省心，API Gateway不会对参数做任何解析，完全交给Lambda处理。

方案二：配置映射模板强制传递字符串参数 #

如果你更倾向于自定义集成请求的参数传递逻辑，可以配置映射模板，让API Gateway把query参数作为纯字符串传递给Lambda：

修改模板如下：

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: Outputs the time
Resources:
  ScheduleFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: dist/index.handler
      Runtime: nodejs6.10
      CodeUri: ./
      Events:
        MyTimeApi:
          Type: Api
          Properties:
            Path: /ScheduleResource
            Method: GET
            # 声明需要接收query参数
            RequestParameters:
              method.request.querystring.query: true
            Integration:
              Type: AWS
              # 指定映射模板，把query参数作为字符串传入
              RequestTemplates:
                application/json: |
                  {
                    "query": "$util.urlDecode($input.params('query'))"
                  }
              # 集成到Lambda需要用POST方法
              IntegrationHttpMethod: POST
              Uri: !Sub arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${ScheduleFunction.Arn}/invocations

这里的关键是RequestTemplates里的配置：

• $input.params('query')获取原始的query参数值
• $util.urlDecode()确保对URL编码后的参数进行解码，还原成原始的GraphQL语句

对应的Lambda代码就可以直接从event里拿到query字段：

exports.handler = async (event) => {
  const graphqlQuery = event.query;
  // 后续处理逻辑
};

额外注意事项 #

• 发起请求时，记得对GraphQL查询字符串进行URL编码（比如把{换成%7B，"换成%22），避免API Gateway因为识别到特殊字符直接返回400
• 如果你用的是旧版本的SAM，可能需要确保模板里的Transform字段是最新的AWS::Serverless-2016-10-31或者更高版本

内容的提问来源于stack exchange，提问作者Matúš Bartko