Docker Compose下Node.js连接Elasticsearch遇ECONNREFUSED错误

你的问题核心在于 depends_on 只保证Elasticsearch容器先启动，但不保证Elasticsearch服务已经完全就绪。当你的Node.js应用尝试连接时，ES容器虽然已经运行，但内部的服务还在初始化（比如加载索引、启动集群），这时候9200端口还没开放，所以会出现ECONNREFUSED错误。而你手动进入容器硬编码IP连接时，ES已经完成初始化，所以能成功连接。

下面是几个可行的解决方案：

1. 在Node.js应用中添加连接重试逻辑 #

最简单的方式是修改你的连接代码，当第一次连接失败时，间隔一段时间重试，直到ES服务就绪：

const { Client } = require('@elastic/elasticsearch');
const hostname = process.env.ES_HOST || 'localhost';
const client = new Client({ node: `http://${hostname}:9200`, log: 'error' });

async function checkConnection() {
  let isConnected = false;
  const maxRetries = 10;
  let retryCount = 0;

  while (!isConnected && retryCount < maxRetries) {
    try {
      console.log(`Attempting to connect to Elasticsearch (attempt ${retryCount + 1})...`);
      const health = await client.cluster.health({});
      console.log('Elasticsearch connection successful:', health);
      isConnected = true;
    } catch (err) {
      retryCount++;
      console.log(`Connection failed, retrying in 5 seconds... (${retryCount}/${maxRetries})`);
      await new Promise(resolve => setTimeout(resolve, 5000));
    }
  }

  if (!isConnected) {
    console.error('Failed to connect to Elasticsearch after maximum retries');
    process.exit(1);
  }
}

checkConnection();
module.exports.client = client;

2. 使用Docker Compose的healthcheck配合depends_on条件（推荐） #

Docker Compose 3.4+版本支持通过healthcheck检测服务是否就绪，然后让Node应用等待ES服务健康后再启动。修改你的docker-compose.yml：

version: '3.8' # 需要至少3.4版本
services:
  express-app:
    build: /path/to/app
    container_name: my_app
    depends_on:
      elasticsearch:
        condition: service_healthy # 等待ES服务健康
    environment:
      - NODE_ENV=local
      - ES_HOST=elasticsearch
      - PORT=3000
    ports:
      - 3000:3000
    networks:
      - backend
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.6.0
    container_name: es-master
    environment:
      - discovery.type=single-node
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    volumes:
      - esdata:/usr/share/elasticsearch/data
    ports:
      - 9200:9200
      - 9300:9300
    networks:
      - backend
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9200/_cluster/health?wait_for_status=yellow&timeout=30s"]
      interval: 10s
      timeout: 10s
      retries: 5
volumes:
  esdata:
    driver: local
networks:
  backend:

这里的healthcheck用curl检测ES的集群健康状态，等待状态变为yellow（单节点集群的正常状态），直到服务就绪后，才会启动Node应用容器。

3. 使用启动等待脚本 #

你可以在Node应用的Dockerfile中添加一个等待脚本，让容器启动前先等待ES的9200端口开放。

首先，把wait-for-it.sh脚本放到你的应用目录，然后修改Dockerfile：

FROM node:14-alpine
WORKDIR /app
COPY wait-for-it.sh .
RUN chmod +x wait-for-it.sh
COPY package*.json ./
RUN npm install
COPY . .
CMD ["./wait-for-it.sh", "elasticsearch:9200", "--", "node", "server/db/index.js"]

这样容器启动时会先等待ES的9200端口可用，再启动Node应用。

额外验证 #

你的其他配置都是正确的：

• 两个服务都在同一个backend桥接网络中，所以用服务名elasticsearch作为主机名是可以解析的
• 环境变量ES_HOST已经正确传递给Node应用
• 硬编码IP能成功也证明网络连通性没问题

所以核心问题就是服务就绪时间差，解决这个问题后，用服务名连接就能正常工作了。

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