如何通过API Gateway灵活传递URL参数至SNS再到Lambda？

一、先搞定自动捕获所有查询参数的配置 #

不用一个个预定义参数，只要在API Gateway的集成请求里设置一个通用的映射模板就行，步骤如下：

1. 打开你的API Gateway对应GET方法的配置页，切换到「集成请求」标签
2. 找到「映射模板」区域，点击「添加映射模板」，输入application/json（别担心GET请求没请求体，这个模板依然生效）
3. 勾选「当没有匹配的模板时通过」，然后把默认模板替换成下面的VTL代码：

{
  "queryParams": $input.params().querystring
}

这个模板会自动把所有查询参数打包成一个字典，比如你发testapi?key1=value1&key2=value2，Lambda收到的事件里就会有{"queryParams": {"key1":"value1", "key2":"value2"}}。要是你想让参数直接在顶层（不用嵌套在queryParams里），直接用下面的模板就行：

$input.params().querystring

二、测试的问题：绕过API Gateway测试UI的限制 #

确实，API Gateway自带的测试UI没法直接输入查询参数，我之前也踩过这个坑，给你几个实用的测试方法：

方法1：用curl快速测试 #

直接在终端敲命令，带上参数就行，比如：

curl "https://你的API_ID.execute-api.你的区域.amazonaws.com/你的部署阶段/testapi?key1=value1&key2=value2"

测试完去CloudWatch看Lambda的日志，就能确认参数有没有传对，或者让Lambda把收到的事件返回，直接看curl的响应也行。

方法2：用Postman这类可视化工具 #

打开Postman新建一个GET请求，把完整的API URL（带参数）输进去，点发送就能看到结果，比curl直观，还能保存测试用例。

方法3：在测试UI里手动模拟查询参数 #

其实测试UI也不是完全没法测，只是藏得有点深：

1. 进入测试UI后，展开顶部的「高级选项」（或者找「Query Strings」输入框），直接填key1=value1&key2=value2就行
2. 要是找不到这个选项，更简单的：把测试UI里默认的请求路径/testapi改成/testapi?key1=value1&key2=value2，然后点测试按钮，同样能触发带参数的请求。

三、验证参数是否正确传递 #

最稳妥的方式是在Lambda里加个日志输出，比如用Python的话：

import json

def lambda_handler(event, context):
    # 打印收到的事件到CloudWatch日志
    print("Received event:", json.dumps(event))
    # 把事件返回，方便测试工具查看
    return {
        'statusCode': 200,
        'body': json.dumps(event)
    }

不管用哪种测试方法，要么看CloudWatch的日志，要么看返回的响应，就能确认参数是不是按你想要的字典格式传过来了。

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