AWS Fargate中React容器调用Node.js API遇127.0.0.1连接拒绝

问题场景 #

在AWS Fargate环境中，尝试让运行React应用的Linux Docker容器调用另一个运行Node.js Express API的Linux Docker容器。已遵循AWS任务网络指南，相关配置如下：

Node.js后端容器任务定义端口映射 #

"portMappings": [
    {
        "name": "xxxx-backend-8001-tcp",
        "containerPort": 8001,
        "hostPort": 8001,
        "protocol": "tcp",
        "appProtocol": "http"
    }
],

React前端容器任务定义端口映射 #

"portMappings": [
    {
        "name": "xxxx-frontend-90-tcp",
        "containerPort": 90,
        "hostPort": 90,
        "protocol": "tcp",
        "appProtocol": "http"
    }
],

当前状态 #

• Node.js容器Dockerfile已暴露8001端口，部署后可正常访问API端点
• React应用通过http://127.0.0.1:8001/{api端点}调用时，浏览器报ERR_CONNECTION_REFUSED
• VPC安全组入站规则已允许所有IPv4流量、协议和端口范围

需要排查是否遗漏关键配置。

核心问题与修复方案 #

• 错误根源：127.0.0.1是浏览器本地回环地址，而非Fargate后端容器地址。React应用运行在用户浏览器中，该地址会让浏览器尝试连接用户本地机器的8001端口，而非Fargate集群内的Node.js容器。

• 正确调用方式

  • 同一任务定义内的容器：如果两个容器属于同一个Fargate任务定义，可直接用localhost:8001调用（同一任务内的容器共享网络命名空间）。
  • 不同任务定义的容器：
    • 通过后端容器所在Fargate任务的私有IP地址或ECS服务发现域名（如ECS Service的DNS名称）发起请求。
    • 确保两个任务处于同一VPC的可通信子网，且安全组规则允许前端任务所在安全组访问后端任务的8001端口（即使已开放全部流量，需确认安全组关联正确）。
  • 前端配置优化：将API地址通过环境变量注入React容器，避免硬编码。比如在任务定义中设置环境变量REACT_APP_API_URL=http://<backend-service-dns>:8001，React应用直接读取该变量发起请求。

• 额外检查点

  • 确认Node.js API监听地址为0.0.0.0而非127.0.0.1（若只监听本地回环，容器外无法访问）。
  • 检查后端ECS Service是否配置了正确的端口映射和负载均衡（若使用ALB），确保服务可被前端任务正常访问。

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