容器间如何连接localhost？Node.js应用Docker化通信故障排查

问题背景 #

本地运行两个Node.js应用app1和app2时，访问localhost:3000可正常实现app1调用app2的接口并返回结果；但Docker化后，app1无法访问app2的localhost:3002端口，添加extra_hosts配置后问题依旧，推测请求指向了app1自身容器的localhost。

原因分析 #

1. 容器网络隔离特性：每个Docker容器拥有独立的网络命名空间，容器内的localhost仅指向自身，而非宿主机或其他容器。app1里请求localhost:3002实际是访问自身容器的3002端口，自然无法连接到app2。
2. extra_hosts配置用途错误：extra_hosts: "host.docker.internal:host-gateway"的作用是让容器访问宿主机网络，而非实现容器之间的通信，因此对当前问题无效。
3. Docker Compose默认网络机制：Docker Compose会自动为所有服务创建自定义桥接网络，同一网络内的容器可通过服务名称直接互相访问，无需依赖宿主机端口映射。

解决办法（推荐方案） #

修改app1中请求app2的地址，将localhost:3002替换为Docker Compose里app2的服务名app2:3002——Compose内置的DNS服务会自动将服务名解析为对应容器的IP地址。

修改后的代码 #

app1/index.js

import fetch from 'node-fetch';
import express from 'express'
const app = express()
const port = 3000

app.get('/', (req, res) => {
    // 替换为服务名app2访问容器间接口
    fetch("http://app2:3002/", {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ "msg": "hello app2" })
    })
        .then(resp => resp.json())
        .then((resp) => {
            res.json(resp)
        })
})

app.listen(port, () => {
    console.log(`app1 listening on port ${port}`)
})

app2/Dockerfile

打开EXPOSE 3002的注释（虽不影响通信，但保持配置准确性）：

FROM node:18-alpine

WORKDIR /app

COPY . .

RUN npm i

# EXPOSE 3000 for app1
EXPOSE 3002

CMD ["node", "index.js"]

docker-compose.yaml（可选优化）

容器间通信无需访问宿主机，可移除extra_hosts配置简化文件：

services:
  app1:
    build: ./app1
    container_name: app1_c
    ports:
      - "3000:3000"

  app2:
    build: ./app2
    container_name: app2_c
    ports:
      - "3002:3002"

验证步骤 #

1. 执行docker-compose up --build启动服务
2. 访问localhost:3000，即可正常获取app2返回的{"msg": "hello to you too"}响应

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