如何自定义AWS API Gateway请求验证的错误响应信息？

没问题，你完全可以利用网关日志里的详细错误信息来生成符合需求的自定义响应，而且不需要额外读取日志文件——API Gateway已经把这些错误信息通过内置变量暴露出来了，直接就能在响应模板里使用。下面是具体的实现步骤：

1. 确认请求验证已开启 #

你已经完成了这一步：为/vehicle路径配置了JSON Schema验证且功能正常，这是实现自定义响应的基础前提。

2. 配置400状态码的自定义响应模板 #

API Gateway允许你为特定状态码设置响应映射模板，用来把系统生成的错误信息转换成你想要的格式：

• 登录AWS控制台，进入API Gateway，找到你的目标API和/vehicle资源对应的方法（比如POST）。
• 切换到方法响应标签页，确保400状态码已存在（如果没有，点击「添加响应」按钮添加）。
• 展开400状态码的配置，找到主体映射模板，点击「添加映射模板」，输入application/json并确认。
• 勾选「从不使用默认模板」，然后在模板编辑器中编写VTL（Velocity模板语言）代码，解析错误信息并生成自定义响应。

3. 编写VTL模板解析错误信息 #

API Gateway把验证失败的详细错误信息存储在$context.error.validationErrorString变量中，这个变量的内容和你在网关日志里看到的完全一致。我们可以通过VTL的字符串处理逻辑，提取出错字段和错误类型，生成你需要的响应格式。

针对你的场景，模板可以这样写：

#set($errorMsg = $context.error.validationErrorString)
#set($customResp = {})

## 处理缺失必填字段的情况（比如缺少vehicleType）
#if($errorMsg.contains("missing required properties"))
    #set($start = $errorMsg.indexOf("[") + 2)
    #set($end = $errorMsg.indexOf("]") - 1)
    #set($entity = $errorMsg.substring($start, $end))
    $customResp.put("entity", $entity)
    $customResp.put("message", "missing")

## 处理字段格式不符合规则的情况（比如licensePlate格式错误）
#elseif($errorMsg.contains("does not match pattern"))
    #set($start = $errorMsg.indexOf("'") + 1)
    #set($end = $errorMsg.indexOf("'", $start))
    #set($entity = $errorMsg.substring($start, $end))
    $customResp.put("entity", $entity)
    $customResp.put("message", "invalid format")

## 处理枚举值不合法的情况（比如vehicleType不是Truck/Trailer）
#elseif($errorMsg.contains("is not one of the allowed values"))
    #set($start = $errorMsg.indexOf("'") + 1)
    #set($end = $errorMsg.indexOf("'", $start))
    $customResp.put("entity", $errorMsg.substring($start, $end))
    $customResp.put("message", "invalid value")

## 其他未覆盖的错误场景，返回兜底响应
#else
    $customResp.put("message", "Invalid request body")
#end

$util.toJson($customResp)

4. 部署API生效 #

写完模板后，记得点击API Gateway控制台顶部的「部署API」按钮，选择对应的部署阶段，这样新的响应配置才会生效。

注意事项 #

• 不同的验证错误场景（比如类型不匹配、字段为空等）对应的错误字符串格式可能略有不同，你可以先触发各种错误，把日志里的错误信息复制出来，调整VTL里的判断逻辑和字符串截取规则，确保能覆盖你需要的所有场景。
• 如果你的API用的是Lambda代理集成，请求验证是在到达Lambda之前执行的，所以这个自定义响应模板依然有效，不需要在Lambda里额外处理验证错误。

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