AWS ECS服务调用遇502协议错误，移除Service Connect后恢复求排查

核心现象 #

服务部署在AWS，链路为CloudFront -> ALB -> ECS Service，本地测试完全正常，但启用ECS Service Connect后，某带请求体和参数的POST端点出现异常：服务侧已接收请求并返回200响应，但CloudFront返回502错误，响应体提示upstream connect error or disconnect/reset before headers. reset reason: protocol error；移除Service Connect服务器端配置后，该端点恢复正常。

可能原因及排查步骤 #

• 协议不兼容问题
  Service Connect默认可能采用HTTP/2协议转发，而你的ALB仅配置了HTTP（HTTP/1.1），协议不匹配会导致链路中出现连接重置。检查Service Connect的协议配置，强制指定为HTTP/1.1后重新测试。
  另外，Service Connect代理可能会修改HTTP响应头，比如错误处理Content-Length或Transfer-Encoding字段，导致CloudFront/ALB无法正确解析响应，触发协议错误。对比启用/禁用Service Connect时的响应头日志，找出差异。

• 超时配置不匹配
  虽然服务最终返回了200，但Service Connect的默认请求超时可能短于该端点的实际处理耗时，导致代理在服务返回响应前就触发了连接重置。调整Service Connect的requestTimeout和connectTimeout参数，延长超时时间后测试。

• 请求内容转发异常
  该端点带有请求体和特定参数，Service Connect在转发时可能对大体积请求体、特殊字符参数处理不当：

  • 尝试使用最小化的有效请求体（比如仅保留必要字段）测试，若能正常响应，说明存在请求体大小限制或内容解析问题。
  • 检查请求参数是否包含非ASCII字符、空格等特殊内容，确认Service Connect是否未正确编码这些内容，导致协议解析失败。

• 端口与监听配置冲突
  确认ALB的监听端口与Service Connect配置的服务端口是否完全匹配，是否存在端口映射错误导致流量无法正确转发。同时检查Service Connect是否强制启用了HTTPS转发，与ALB的HTTP配置冲突。

• 日志分析定位
  开启ECS Service Connect的CloudWatch日志和ALB的访问日志，重点查看：

  • Service Connect代理在转发请求/响应时的错误日志，是否有协议解析失败的具体提示。
  • 对比启用和禁用Service Connect时的请求链路日志，找出流量转发过程中的差异点。

快速验证方案 #

1. 明确将Service Connect的协议设置为HTTP/1.1，与ALB的HTTP配置对齐，测试端点是否恢复。
2. 临时调大Service Connect的超时参数（如requestTimeout设为30秒），观察错误是否消失。
3. 使用简化的请求体和参数测试，排查是否为请求内容导致的转发异常。

内容的提问来源于stack exchange，提问作者Ádám Sütő