Docker容器中Node.js无法连接Elasticsearch问题求助

现象总结 #

• Elasticsearch容器正常运行，宿主机浏览器可通过localhost:9200访问，但Node.js容器无法通过服务名elasticsearch:9200建立连接
• 容器内执行curl elasticsearch:9200返回curl: (6) Could not resolve host: elasticsearch，尝试host.docker.internal同样报错
• Kibana可通过localhost:5601打开，但因Elasticsearch连接失败无法加载指标
• Node.js环境变量ELASTIC_SEARCH_URL已正确设置为http://elasticsearch:9200，代码自带重试逻辑但仍触发超时错误

核心原因：容器网络隔离 #

Docker容器间通过服务名通信的前提是处于同一个自定义网络。你的Elasticsearch服务绑定了elastic网络，但notification服务默认加入的是根目录docker-compose创建的默认网络，两个网络完全隔离，导致服务名无法解析。

解决方案步骤 #

1. 统一容器网络

修改根目录的docker-compose.yaml，将notification服务显式加入elastic网络：

version: '3.9'

services:    
  elasticsearch:
    extends:
      service: elasticsearch
      file: infra/docker/docker-compose-elasticsearch.yaml

  kibana:
    extends:
      service: kibana
      file: infra/docker/docker-compose-kibana.yaml

  notification:
    extends:
      service: notification
      file: api/notification/docker-compose.yaml
    depends_on:
      - elasticsearch
    networks:
      - elastic  # 新增：加入Elasticsearch所在的网络

networks:
  elastic:
    name: elastic

注意：确保notification服务自身的docker-compose.yaml中不要单独定义networks配置，避免网络冲突。

2. 优化服务就绪等待逻辑

depends_on仅保证容器启动顺序，不确保Elasticsearch服务完全就绪。在你的重试逻辑中增加固定延迟，避免频繁重试：

export const checkConnection = async (): Promise<void> => {
  let isConnected = false;
  const retryDelay = 5000; // 每次失败后等待5秒再重试

  while (!isConnected) {
    try {
      const health: ClusterHealthResponse = await elasticSearchClient.cluster.health({});
      logger.info(`NotificationService ElasticSearch health status - ${health.status}`);
      isConnected = true;
    } catch (error) {
      logger.error('Connection to ElasticSearch failed. Retrying in 5 seconds...');
      logger.log('error', 'NotificationService checkConnection() method:', error);
      await new Promise(resolve => setTimeout(resolve, retryDelay)); // 新增延迟
    }
  }
};

3. 验证网络连通性

启动所有服务后，进入notification容器测试网络：

docker exec -it notification bash
curl http://elasticsearch:9200

如果返回Elasticsearch的节点信息，说明网络已正常连通。

4. 确认Elasticsearch绑定地址

确保Elasticsearch监听所有网卡地址（默认配置为0.0.0.0），你的现有配置未修改该参数，无需额外调整。若手动设置过network.host，需保证值为0.0.0.0或容器内部IP。

常见误区说明 #

• 容器内的localhost指容器自身，而非宿主机，因此Node.js容器用localhost:9200无法访问宿主机的Elasticsearch端口
• Docker默认桥接网络的服务名解析稳定性较差，自定义网络是容器间通信的可靠选择
• 你已关闭xpack.security.enabled，排除了认证权限导致的连接问题

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