API Gateway测试可调用Lambda，直接访问端点返回500且未触发Lambda

一、公网访问端点返回500、Lambda未触发的排查方向 #

• 优先检查API Gateway部署状态：控制台测试调用会读取当前编辑的最新配置，公网访问的是已部署到对应阶段的历史版本，如果修改完集成配置后没有执行部署操作，公网请求会匹配不到正确的集成规则，直接返回500且不会触发Lambda。
• 检查访问控制规则：确认API Gateway是否配置了资源策略、WAF规则、IP白名单限制，若公网请求的来源IP/特征被规则拦截，请求会在接入层直接返回错误，不会进入Lambda触发流程。
• 检查API Gateway执行角色权限：控制台测试使用当前登录账号的权限调用Lambda，公网请求使用API Gateway专属执行角色的权限，需确认该角色已被授予lambda:InvokeFunction权限，且权限策略中指定的Lambda ARN与实际集成的Lambda完全匹配。
• 检查请求方法与路径匹配规则：确认公网发起的请求方法（GET/POST/PUT等）、请求路径与API Gateway配置的方法、路径映射规则完全一致，不匹配的请求会直接返回500，不会触发集成。

二、控制台测试返回502、Lambda超时的解决方案 #

• Lambda默认执行超时时间为3秒，直接调整Lambda函数的超时配置即可，最高可设置为15分钟，若对接API Gateway需注意API Gateway本身的超时上限为30秒，Lambda超时配置不要超过该阈值。
• 若Lambda配置了VPC接入，需检查对应子网的路由规则、安全组出网规则，确认Lambda可以正常访问依赖的外部接口、AWS服务端点，网络不通是Lambda执行超时的高发原因。

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