ECS集群中通过Service Connect从Python连接Redis容器失败

问题背景 #

基于Python+Redis的应用在本地Docker Compose环境运行正常，但部署到AWS ECS集群（通过Service Connect实现服务间通信）后出现连接异常：Python容器内用redis-cli连接失败，Python终端连接返回400 Bad request错误，无法通过ping()得到预期的OK响应。

已完成的排查动作：

• 确认Python容器6379端口已开放
• 验证主机名celeryredis指向的Redis服务正常运行，且Python容器可解析该主机名
• 测试Redis无密码/设置密码两种场景，问题均存在
• 尝试显式指定连接URL：r = redis.from_url("redis://celeryredis:6379/0")
• 切换为awsvpc网络模式，问题未解决
• 确认使用TCP协议
• Redis开启debug日志级别，未记录到任何客户端连接日志

核心排查与解决方案 #

1. 修正Service Connect的端口协议配置 #

400错误的常见原因是Service Connect代理将Redis的TCP流量误识别为HTTP协议处理：

• 登录AWS控制台，进入ECS集群的Service Connect配置页，确认Redis服务的端口协议设置为TCP而非HTTP
• 检查Python服务的Service Connect端点配置，确认引用的Redis服务端口为6379，无端口映射错误

2. 验证容器内网络连通性 #

在Python容器内执行以下命令，排查底层网络问题：

# 解析Redis服务的IP地址
nslookup celeryredis
# 测试端口连通性
telnet celeryredis 6379

若telnet连接后输入PING返回+PONG，说明网络层正常，问题出在客户端配置；若telnet连接失败，需检查ECS安全组、网络ACL是否允许服务间TCP 6379端口的流量。

3. 排查redis-cli连接参数 #

尝试用显式参数调用redis-cli，避免协议混淆：

redis-cli -h celeryredis -p 6379 ping

若仍报错，抓包分析请求内容，确认是否发送了非Redis协议的请求：

tcpdump -i any port 6379 -A

查看数据包中是否存在GET /等HTTP头，若有则说明客户端请求格式错误。

4. 简化redis-py连接测试 #

排除复杂URL解析问题，用基础连接方式测试并捕获完整异常：

import redis
try:
    r = redis.Redis(host='celeryredis', port=6379, db=0, socket_connect_timeout=5)
    print(r.ping())
except Exception as e:
    print(f"Error: {type(e).__name__} - {str(e)}")

同时确认redis-py版本与Redis服务器版本兼容，避免因版本差异导致的协议不匹配。

5. 检查Redis服务绑定地址 #

Redis默认绑定127.0.0.1，若ECS容器内的Redis仍使用该配置，即使Service Connect解析到主机名也无法连接：

• 修改Redis配置文件，将bind设置为0.0.0.0，或直接注释掉bind行以允许所有地址访问
• 重启Redis服务并验证绑定地址：redis-cli CONFIG GET bind

6. 查看Service Connect代理日志 #

Service Connect依赖Envoy代理转发流量，代理配置错误也会导致异常：

• 在ECS任务的日志流中查找Envoy代理的日志，搜索6379端口相关的转发错误、协议不匹配信息
• 确认任务定义中Service Connect代理配置正确，TCP流量未被错误拦截

内容的提问来源于stack exchange，提问作者vani s Varrier