Terraform部署API Gateway集成Lambda触发失败问题求助

一、API Gateway部署与路径配置检查 #

• 确认API Gateway已重新部署到目标stage（如test）：Terraform变更后，必须将API部署到对应stage才会生效，未部署的话旧配置仍在运行，会导致路径不匹配或集成未生效。
• 根路径(/)问题排查：
  • 检查根路径是否创建了对应方法（GET/POST等），且该方法的authorization_type确实设为NONE。若根路径未配置任何方法，API Gateway默认返回"Missing Authentication Token"。
  • 查看stage级配置，是否开启了API key强制要求或其他认证规则，这类全局配置会覆盖单个方法的权限设置。
• 目标路径(/resource)验证：
  • 确认/resource的对应方法（如GET）已正确绑定Lambda集成，检查集成类型是AWS_PROXY还是AWS：AWS_PROXY需符合Lambda代理格式，AWS类型则要配置正确的请求/响应模板。

二、Lambda权限与关联检查 #

• 验证Lambda资源策略：API Gateway必须拥有调用Lambda的权限，通过Terraform的aws_lambda_permission资源配置时，需确保：
  • action设为lambda:InvokeFunction
  • principal为apigateway.amazonaws.com
  • source_arn匹配API Gateway的ARN格式：arn:aws:execute-api:<region>:<account-id>:<api-id>/<stage>/<http-method>/<resource-path>（路径含通配符时需对应正确）
  • 在Lambda控制台「配置-权限」中确认该策略已存在并生效。
• Lambda触发器UI不显示的说明：通过Terraform手动配置API集成时，Lambda控制台的触发器列表可能不会显示关联记录，但这不代表集成无效，重点以权限和API Gateway的集成配置为准。

三、日志与控制台测试排查 #

• 开启API Gateway执行日志：在stage设置中启用CloudWatch日志，设置日志级别为INFO或ERROR，调用路径后查看日志中的具体错误（如权限拒绝、集成格式错误等）。
• 使用API Gateway控制台测试功能：在对应方法的「测试」标签页发起请求，查看返回的详细错误信息，快速定位是API Gateway内部错误还是集成问题。
• 检查集成请求配置：若用AWS_PROXY集成，确保请求格式符合Lambda代理要求；若用AWS集成，确认请求模板已正确转换API Gateway请求为Lambda可处理的格式，响应模板也配置正确。

四、Terraform代码验证 #

• 检查API Gateway资源配置：
  • 确认aws_api_gateway_resource的parent_id正确关联到根资源（aws_api_gateway_rest_api.root.root_resource_id）。
  • 确认aws_api_gateway_method的authorization_type为NONE，且http_method与调用方法一致。
  • 确认aws_api_gateway_integration的uri正确指向Lambda ARN，格式为arn:aws:apigateway:<region>:lambda:path/2015-03-31/functions/<lambda-arn>/invocations。
• 查看Terraform执行日志：运行terraform apply时，检查是否有警告或错误（如权限资源创建失败、部署未完成等）。

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