Docker环境下两个Express微服务间通信被拒绝问题求助

问题分析 #

从错误日志connect ECONNREFUSED 127.0.0.1:3001可知，cart-service实际在尝试连接本地localhost的3001端口，而非你代码中指定的product-service:3001。这说明要么代码中的服务地址未正确生效，要么product-service的端口监听配置存在问题。

解决方案 #

1. 确保product-service监听正确地址 #

Express服务默认仅监听127.0.0.1，在Docker容器中该地址仅容器内部可访问，同网络内的其他容器无法通过服务名连接。需修改product-service的启动代码，让它监听0.0.0.0：

// product-service启动代码示例
const app = require('express')();

// 监听0.0.0.0，允许同网络内其他容器访问
app.listen(3001, '0.0.0.0', () => {
  console.log('Product service running on port 3001');
});

2. 验证请求URL是否实际生效 #

检查cart-service代码，确认没有其他逻辑覆盖请求地址。比如是否误用环境变量且未正确配置：

// 错误示例：环境变量未设置时默认指向localhost
const productServiceUrl = process.env.PRODUCT_SERVICE_URL || 'http://localhost:3001';

// 正确配置：默认使用Docker服务名
const productServiceUrl = process.env.PRODUCT_SERVICE_URL || 'http://product-service:3001';

可在cart-service中打印实际发送的请求URL，确认地址与预期一致。

3. 测试容器间网络连通性 #

进入cart-service容器，直接验证与product-service的连通性：

# 进入cart-service容器
docker exec -it <cart-service容器ID> sh

# 先ping product-service，确认DNS解析正常
ping product-service

# 用curl测试接口连通性
curl -X POST http://product-service:3001/api/product/checkout \
  -H "Content-Type: application/json" \
  -d '{"cart": [], "token": "test"}'

若ping不通，检查两个容器是否都加入了my_network网络；若curl返回连接拒绝，说明product-service未正常启动或端口监听错误。

4. 处理服务启动顺序问题 #

depends_on仅保证容器启动顺序，不保证服务完全就绪。若cart-service在product-service未启动完成时发起请求，也会出现连接拒绝。可给product-service添加健康检查：

# docker-compose.yml中修改product-service配置
product-service:
  image: sahilhakimi/topshelf-product:latest
  # ...其他原有配置
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:3001/health"] # 需确保服务有健康检查接口
    interval: 10s
    timeout: 5s
    retries: 3
    start_period: 30s

再修改cart-service的depends_on，等待product-service健康就绪：

cart-service:
  # ...其他原有配置
  depends_on:
    - cache
    - kafka
    - product-service:
        condition: service_healthy

总结 #

核心问题是cart-service实际请求的是localhost而非product-service，优先检查服务监听地址和请求URL的正确性，再验证网络连通性和服务就绪状态。

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