Windows11下Java无法连接Docker中Elasticsearch的修复求助

Docker Desktop在Windows/macOS是基于虚拟机运行的，和Ubuntu直接使用宿主机网络的机制不同：

• ES容器启动后，会把自身的容器内部IP（比如172.17.0.x）注册到集群元数据中。
• 当Transport Client开启嗅探时，会从ES节点拉取集群内的节点列表，拿到的是这个内部IP，但Windows/macOS宿主机无法直接访问Docker虚拟机内的容器IP，导致客户端找不到可用节点，抛出异常。
• Ubuntu下Docker默认用桥接网络，宿主机能直接访问容器内部IP，所以不会出问题。

方案1：配置ES发布宿主机可访问的地址（简单推荐） #

修改Docker-Compose中Elasticsearch的环境变量，添加transport.publish_host指定Docker Desktop内置的宿主机映射地址：

environment:
  - discovery.type=single-node
  - cluster.name=mycluster
  - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
  - xpack.security.enabled=false
  - network.host=0.0.0.0  # 允许所有IP访问ES
  - transport.publish_host=host.docker.internal  # 发布宿主机可访问的地址

• host.docker.internal是Docker Desktop提供的特殊域名，会自动映射到宿主机的IP，客户端嗅探时拿到的是这个地址，就能正常连接ES的9300端口。
• 修改后重启ES容器，恢复client.transport.sniff=true即可。

方案2：固定ES容器IP并配置host映射 #

1. 在Docker-Compose中创建自定义网络并给ES分配固定IP：

version: '3.5'

networks:
  es-net:
    driver: bridge
    ipam:
      config:
        - subnet: 192.168.200.0/24

services:
  elasticsearch:
    # ... 其他配置不变
    networks:
      es-net:
        ipv4_address: 192.168.200.10
    environment:
      # ... 原有环境变量添加
      - transport.publish_host=192.168.200.10

2. 在Windows/macOS的hosts文件中添加映射：

192.168.200.10 elasticsearch

这样客户端嗅探到的是固定的可访问IP，就能正常建立连接。

方案3：替换为REST Client（长期最优） #

Transport Client在ES 7.x已被弃用，8.x完全移除，官方推荐使用High Level REST Client，它基于HTTP协议，和浏览器访问ES的方式一致，彻底避免Transport协议的网络适配问题。

适配ES 6.2.4的示例代码：

RestHighLevelClient client = new RestHighLevelClient(
        RestClient.builder(
                new HttpHost("localhost", 9200, "http")));

使用REST Client不需要依赖9300端口，直接通过映射的9200端口访问，跨环境兼容性更好，也减少后续版本升级的迁移成本。

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