AWS Serverless含未编码^字符请求报错，如何在Lambda/CloudFront解决？

这个问题我之前帮客户排查过好几次，核心原因很明确：^属于URL规范里的保留字符，CloudFront默认会严格校验请求的URL格式，直接拒绝包含未编码非法字符的请求，连API Gateway都到不了，更别说Lambda了。下面给你分几个层级的解决方案，从最直接的前端拦截调整，到后端的兜底处理：

这是最直接的解决方式，让CloudFront放过包含^的请求：

• 登录CloudFront控制台，找到对应的分发资源
• 切换到行为标签页，选中你要修改的行为（比如默认的/*行为），点击「编辑」
• 滚动到缓存键和源请求区域，展开后找到查询字符串相关设置
• 找到「允许的查询字符串字符」输入框，添加^到列表中（多个字符用逗号分隔，直接写^就行，不需要转义）
• 保存更改，等待CloudFront的配置分发更新（通常需要10-15分钟生效）
• 测试：重新运行你的curl命令，这次请求应该能正常抵达Lambda了

如果CloudFront由其他团队管理，或者暂时不能修改配置，可以在API Gateway这边开放字符限制，但前提是CloudFront已经把请求转发过来了：

• 登录API Gateway控制台，进入你的目标API
• 点击左侧导航的设置选项
• 在「API设置」页面找到「允许的查询字符串字符」，把^添加到输入框中
• 重新部署API到对应的阶段（必须部署才会生效）
• 注意：如果CloudFront还是拦截请求，这个配置不会起作用，所以优先确保CloudFront的规则允许请求通过

如果前面的层级已经允许请求通过，你可以在Lambda里对参数做解码处理，兼容编码/未编码的情况：
比如Python的示例代码：

import urllib.parse

def lambda_handler(event, context):
    query_params = event.get('queryStringParameters', {})
    if 'id' not in query_params:
        return {'statusCode': 400, 'body': "Missing 'id' parameter"}
    
    # 解码参数，兼容编码和未编码的情况
    decoded_id = urllib.parse.unquote(query_params['id'])
    # 这里写你的业务逻辑
    return {'statusCode': 200, 'body': f"Received valid id: {decoded_id}"}

其实按照URL规范，^这类保留字符应该被编码后再发送，正确的curl命令应该是：

curl -X GET 'https://lambda.com/call?id=inva%5Elid'

（^的URL编码是%5E）如果QA团队可以调整测试用例，这是更规范的做法。

内容的提问来源于stack exchange，提问作者Tzook Bar Noy