通过AWS暴露GRPC服务遇FRAME_SIZE_ERROR问题求助

遇到FRAME_SIZE_ERROR: 4740180错误，本质是ALB返回了HTTP 1.1格式的响应，而GRPC客户端预期的是HTTP/2帧。以下是具体排查和修复步骤：

1. 确认ALB监听器的HTTP/2配置 #

AWS ALB的GRPC依赖HTTP/2协议，若HTTPS监听器禁用了HTTP/2，会导致流量被强制转为HTTP 1.1。检查你的aws_alb_listener.https资源：

• 确保没有设置http2_enabled = false，显式开启的话配置如下：

resource "aws_alb_listener" "https" {
  # 其他已有配置（如负载均衡ARN、端口等）
  protocol       = "HTTPS"
  http2_enabled  = true  # 必须开启，默认值为true，但需确认未被手动禁用
  # 证书、默认动作等其他配置
}

2. 匹配目标组与容器的协议 #

目标组的protocol必须和容器内GRPC服务的通信方式一致：

• 如果容器内的GRPC服务是明文传输（未启用TLS），目标组protocol应设为HTTP，而非HTTPS。修改目标组配置：

resource "aws_alb_target_group" "main_printer" {
  name_prefix      = "print"
  port             = var.container_printer_port
  protocol         = "HTTP"  # 容器明文GRPC时用HTTP
  protocol_version = "GRPC"
  vpc_id           = var.vpc_id
  target_type      = "ip"

  tags = {
    Name        = "${var.name}-tg-printer-${var.environment}"
    Environment = var.environment
  }

  lifecycle {
    create_before_destroy = true
  }
}

• 若容器内服务启用了TLS，再保持protocol = "HTTPS"，同时确认容器的证书配置正确，能解密ALB发送的TLS流量。

3. 排查监听器规则冲突 #

检查是否有优先级更高（priority数值更小）的监听器规则，匹配了同一个var.website_printer_fqdn主机头，导致流量被转发到非GRPC目标组。

• 调整aws_alb_listener_rule.main_printer的priority为比其他同主机头规则更小的数值，确保GRPC规则优先匹配：

resource "aws_alb_listener_rule" "main_printer" {
  listener_arn = aws_alb_listener.https.arn
  priority     = 10  # 设为比冲突规则更小的优先级

  condition {
    host_header {
      values = [var.website_printer_fqdn]
    }
  }

  action {
    type             = "forward"
    target_group_arn = aws_alb_target_group.main_printer.arn
  }
}

4. 验证容器内GRPC服务的正确性 #

直接在容器所在主机或容器内部测试服务是否正常：

• 使用grpcurl工具测试（需提前安装）：

# 明文GRPC服务
grpcurl -plaintext localhost:${var.container_printer_port} list
# TLS加密的GRPC服务
grpcurl -insecure localhost:${var.container_printer_port} list

如果命令返回GRPC服务列表，说明服务本身正常；若返回HTTP响应（如404 Not Found），则是服务配置错误，需检查GRPC服务的启动参数。

5. 确认SNI与证书配置 #

• 验证data.aws_acm_certificate.certificate_printer获取的证书域名与var.website_printer_fqdn完全匹配，包括通配符（如*.example.com匹配printer.example.com）。
• 确保GRPC客户端请求时发送了正确的SNI（Java GRPC客户端默认自动发送，无需额外配置）。

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