使用elasticsearch-php连接Docker部署Elasticsearch提示无存活节点求助

• 已通过Docker部署Elasticsearch，本地浏览器访问localhost:9200可正常获取服务响应，Elasticsearch本身运行无异常
• 项目已引入elasticsearch/elasticsearch-php扩展包，运行测试代码时会在第64行抛出No alive nodes found in your cluster报错
• 已查阅公开文档中该报错的通用解决方案并逐一尝试，问题仍未解决，暂未定位到操作疏漏点
• 已尝试配置3类连接主机地址，均无法实现连通：
  • http://localhost:9200/
  • localhost
  • docker_elastic_1:9200

$client = \Elasticsearch\ClientBuilder::create()->build();

$params = [
    'index' => 'my_index',
];

$response = $client->indices()->create($params);
print_r($response);

• 首先明确：你当前的测试代码没有显式传入hosts配置，ClientBuilder默认会将127.0.0.1:9200作为唯一连接节点，如果这个地址在PHP代码的实际运行环境内不可达，就会直接触发报错。
• 网络连通性层面的排查（占该类报错的80%以上场景）
  1. 如果你的PHP代码是直接在本地宿主机运行、没有跑在Docker容器里：
     • docker_elastic_1:9200这类用Docker容器名作为主机的配置永远无法连通——Docker的容器名DNS解析只在同自定义网络的容器之间生效，宿主机不在这个解析体系内。
     • 先执行命令docker port <你的Elasticsearch容器名>，确认9200端口已经正确映射到宿主机的对应端口，避免出现容器内服务正常、但端口没有映射到宿主机的情况。
     • 连接地址统一写为http://127.0.0.1:9200，不要带末尾斜杠。
  2. 如果你的PHP代码是跑在Docker容器里：
     • localhost在容器内指的是PHP容器自身的网络回环地址，既不是宿主机地址、也不是Elasticsearch容器的地址，自然无法连通。
     • 需要将PHP容器和Elasticsearch容器接入同一个自定义Docker bridge网络，之后使用Elasticsearch容器在该网络内的服务名作为连接地址，格式为http://<ES容器服务名>:9200。
• 安全配置层面的排查
  1. 新版Elasticsearch（8.x及以上版本）默认开启xpack安全认证，即使浏览器访问9200能看到节点返回信息，没有携带认证信息的请求会被直接拦截，PHP扩展如果没有配置认证信息，就会判定节点不可用。
  2. 解决方式：初始化客户端时显式配置认证信息，参考代码：

     $client = \Elasticsearch\ClientBuilder::create()
         ->setHosts(['http://<实际可达的ES节点地址>:9200'])
         ->setBasicAuthentication('elastic', '你部署时设置的elastic账号密码')
         ->build();
     

• 节点发布地址配置的排查
  1. 如果Elasticsearch启动时没有正确配置network.publish_host，默认会将容器内部的虚拟网卡地址作为节点发布地址，PHP扩展初始连接到节点后，会收到节点返回的内部地址列表，由于这个内部地址对PHP端不可达，就会判定没有存活节点。
  2. 解决方式：修改Elasticsearch启动配置，设置network.publish_host为节点在当前网络内的可达地址，重启服务后再测试连接。
• 连通性验证小技巧：在PHP代码的实际运行环境内，先执行curl命令测试ES地址的连通性——比如执行curl http://<你配置的ES地址>:9200，如果这个请求都拿不到正常的JSON响应，PHP扩展肯定无法连通，先把网络通了再测试扩展连接。

内容的提问来源于stack exchange，提问作者Burhan Çelebi