为何AWS ECS容器连接MongoDB Atlas时触发MongoSocketReadException异常？

异常差异说明 #

com.mongodb.MongoSocketReadException: Prematurely reached end of stream和Connection refused的本质区别：

• Connection refused：TCP连接根本无法建立，属于初始连接失败
• MongoSocketReadException：TCP连接已成功建立，但在MongoDB客户端与Atlas节点通信过程中，连接被意外中断，属于连接后通信异常

ECS+Atlas场景下的排查与修复方案 #

1. 检查Atlas的IP白名单配置 #

Atlas默认仅允许白名单内的IP访问，ECS容器的出口IP通常不固定：

• 若使用ECS Fargate模式，需将VPC的NAT网关IP加入Atlas白名单
• 若使用ECS EC2模式，需将EC2实例的公网IP或所在VPC的CIDR段加入白名单
• 生产环境避免直接配置0.0.0.0/0，严格限制IP范围

2. 验证ECS容器的网络配置 #

• 确认ECS任务的网络模式（awsvpc/bridge/host）允许容器访问公网（Atlas为托管服务，通常需公网访问）
• 若使用awsvpc模式，检查任务所属安全组是否允许出站访问MongoDB默认端口27017
• 检查VPC路由表是否配置指向NAT网关的路由，确保容器具备公网访问能力

3. 调整MongoDB客户端连接参数 #

• 增加连接超时与Socket超时时间，避免因响应延迟引发流中断：

  MongoClientSettings settings = MongoClientSettings.builder()
      .applyConnectionString(new ConnectionString("mongodb+srv://<your-connection-string>"))
      .applyToSocketSettings(builder -> 
          builder.connectTimeout(Duration.ofSeconds(30))
                 .readTimeout(Duration.ofSeconds(30)))
      .build();
  

• 开启客户端连接池监控，排查是否存在连接频繁回收或超时的情况
• 确认客户端已开启TLS/SSL（Atlas强制要求加密连接，需配置ssl=true）

4. 排查Atlas集群状态 #

• 登录Atlas控制台，确认集群无节点故障、无正在执行的维护任务
• 查看Atlas日志，检查是否存在针对ECS出口IP的异常连接记录
• 验证Atlas集群版本与客户端驱动版本的兼容性（例如MongoDB 5.0+建议使用4.0及以上版本的Java驱动）

5. 检查ECS容器资源限制 #

• 若容器CPU或内存资源不足，可能导致客户端进程无法及时处理MongoDB响应，引发流中断
• 查看ECS任务的CloudWatch日志，排查是否存在OOM（内存不足）或CPU使用率过高的记录

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