创建ApiGatewayV2 HTTP API与SQS-SendMessage集成时遇400错误

DevOps 小满

2026-8-15

问题解决：CloudFormation部署HTTP API到SQS集成报400错误

错误原因

你遇到的Operation: SQS-SendMessage is not supported错误，核心是集成类型配置错误：

HTTP API与SQS这类AWS服务的直接集成，需要使用IntegrationType: AWS，而非AWS_PROXY。AWS_PROXY仅适用于Lambda代理集成，无法配合IntegrationSubtype指定SQS操作。

修正后的集成配置

将CloudFormation片段中的IntegrationType改为AWS，修正后的代码如下：

Integration:
  Type: AWS::ApiGatewayV2::Integration
  Properties:
    ApiId: ${param:HttpAPIRef}
    IntegrationSubtype: SQS-SendMessage
    IntegrationType: AWS  # 此处修改为AWS
    ConnectionType: INTERNET
    PayloadFormatVersion: 1.0
    CredentialsArn: !GetAtt HttpApiRole.Arn
    RequestParameters:
      QueueUrl: !Ref Queue
      MessageBody: "random+text"  # 建议添加引号避免YAML解析异常

进一步调试步骤

对比控制台配置：用AWS CLI执行aws apigatewayv2 get-integration --api-id <你的HttpAPI ID> --integration-id <控制台创建的集成ID>，查看控制台生成的集成参数，和你的CloudFormation模板逐一对比，重点检查IntegrationType、IntegrationSubtype、RequestParameters的格式差异。
检查CloudFormation事件日志：在AWS控制台的CloudFormation服务中，找到对应堆栈，查看部署事件的详细错误信息，确认是否存在资源引用错误（比如HttpAPIRef或Queue不存在）。
验证IAM角色权限：确保HttpApiRole的权限策略包含sqs:SendMessage动作，且信任策略允许apigateway.amazonaws.com作为调用主体。示例权限策略：
```
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sqs:SendMessage",
      "Resource": !Ref Queue
    }
  ]
}
```
测试Payload格式：若需要传递动态请求体，将MessageBody改为$request.body，并确保PayloadFormatVersion设置为1.0（HTTP API与SQS集成的推荐版本）。