如何让携带<>^|特殊字符的URL请求通过API Gateway到达后端Lambda

问题根因 #

你遇到的400错误是AWS API Gateway的前置URL合法性校验逻辑触发的，完全符合RFC 3986 URI规范要求：<、>、^、|都属于非URI安全字符，禁止直接出现在URL路径/查询字符串中，必须经过URL编码后才能传输。这类非法请求会在API Gateway的接入层直接被拦截，不会流转到WAF、集成后端（Lambda），也不会记录到普通的API调用日志、WAF日志中，因此你查询不到命中记录属于正常现象。

可行解决方案 #

优先方案

• 固化URL编码调用规范：你当前采用的「告知用户对URL特殊字符做编码」的方案是最符合行业标准、无额外成本、无兼容性风险的最优解，建议直接固化为接口调用要求，所有调用方传参前必须对URL中的特殊字符做编码处理，比如用%7C代替|。

兼容类方案（仅适用于无法约束客户端行为的场景）

• 调整参数传递方式：如果特殊字符属于业务参数内容，建议将这部分参数从URL路径/查询字符串移动到请求体中传递，POST、PUT等请求的请求体不受URL字符规范限制，不需要编码即可直接传输这类特殊字符。
• 开启访问日志统计请求量级：如果需要先评估适配必要性，可以开启API Gateway的全量访问日志，配置日志格式时添加$context.error.message、$context.httpStatus字段，即可捕获到这类400错误的请求记录，统计非法请求的量级、来源后再判断是否需要做适配。
• 前置反向代理自动转码：如果必须兼容未编码的客户端请求，可以在API Gateway前加一层自定义反向代理（比如Nginx、CloudFront + Edge Lambda），在代理层识别URL中未编码的特殊字符，自动转为URL编码格式后再转发给API Gateway，该方案会额外增加架构复杂度和运行成本，建议仅在业务必要时采用。

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