Docker内部网络下Node Fetch跨容器调用失败问题求助

核心排查与解决步骤： #

1. 确认容器处于同一自定义Docker网络
   默认的bridge网络对容器名称解析支持有限，必须将两个容器放到同一个自定义网络中：

• 查看现有网络：docker network ls
• 检查容器所属网络：docker inspect <容器名/ID> | grep Networks
• 创建自定义网络（如果没有）：docker network create app-internal-net
• 重新启动容器并加入该网络：

  docker run --name backend --network app-internal-net -d <你的后端镜像>
  docker run --name frontend --network app-internal-net -d <你的前端镜像>
  

2. 修正前端代码的请求地址

• 绝对不能用localhost或127.0.0.1，这在前端容器中指向容器自身，而非后端。
• 使用后端容器的名称（如backend）或其在自定义网络内的IP作为请求地址，端口用后端服务的内部监听端口（不是映射到主机的外部端口）。
  示例（前端Node.js/fetch代码）：

  // 正确写法：用容器名+内部端口
  fetch('http://backend:3000/api/data')
    .then(res => res.json())
    .then(data => console.log(data));
  

3. 检查后端服务的监听地址
   后端Node.js服务必须监听0.0.0.0而非127.0.0.1，否则仅允许容器内部访问：
   示例（Express后端代码）：

// 正确监听地址
app.listen(3000, '0.0.0.0', () => {
  console.log('Backend running on port 3000');
});

4. 验证容器间连通性
   进入前端容器直接测试，定位问题是否出在网络或代码：

# 进入前端容器
docker exec -it frontend sh
# 测试后端连通性（用内部端口）
curl http://backend:3000/api/data

• 如果curl能返回数据，说明网络正常，问题在前端代码的请求地址配置。
• 如果curl失败，检查后端容器日志：docker logs backend，确认服务正常启动、端口正确监听。

5. 排查防火墙限制

• 主机防火墙不要拦截Docker内部网段（通常是172.17.0.0/16或自定义网络的网段）的流量。
• 容器内部默认无防火墙，若手动配置过iptables，需放行内部网络的入站请求。

（可选）用Docker Compose简化配置 #

若使用Docker Compose，默认会创建专属网络，服务名可直接作为域名使用：

version: '3.8'
services:
  backend:
    build: ./backend
    # 外部端口映射可选，内部用3000
    ports:
      - "8080:3000"
  frontend:
    build: ./frontend
    ports:
      - "3001:80"
    depends_on:
      - backend

前端代码直接用http://backend:3000发起请求即可。

内容的提问来源于stack exchange，提问作者Suman Dep Nath