AWS API Gateway请求验证失效问题排查与修复咨询

1. 检查新增方法的OpenAPI请求体定义 #

• 确保POST /foos的OpenAPI配置里明确声明requestBody，并设置required: true（如果请求体是必填项）。同时要绑定正确的JSON Schema，示例如下：

  paths:
    /foos:
      post:
        requestBody:
          required: true
          content:
            application/json:
              schema:
                type: object
                required: ["name"]
                properties:
                  name:
                    type: string
  

• 若未定义requestBody或required设为false，全局验证器不会触发请求体校验。

2. 确认全局验证器未被局部配置覆盖 #

• 全局验证器设为"all"后，检查新增方法是否单独配置了局部验证器（局部配置会覆盖全局）。
• 在CloudFormation的RestApi资源或OpenAPI的x-amazon-apigateway-request-validator扩展中，若存在局部验证器配置，要么删除该配置，要么将其指定为全局验证器的ID。

3. 验证Lambda代理集成配置 #

• Lambda代理集成不影响API Gateway的前置请求验证，需确认：
  • 方法的x-amazon-apigateway-integration中无禁用验证的特殊配置；
  • 未通过security或其他配置绕过验证逻辑。

4. 重新部署API到目标阶段 #

• 修改OpenAPI或CloudFormation配置后，必须重新部署API到对应阶段，否则修改不会生效。可通过CloudFormation的Deployment资源自动部署，或在控制台手动操作。

5. 检查阶段级别的验证器设置 #

• 进入API Gateway控制台，找到对应阶段，在"Settings"中确认"Request Validator"已选中全局验证器。
• 若阶段级验证器设置为空，可能无法继承全局配置，需手动指定。

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