使用Python客户端连接ElasticSearch/OpenSearch失败但curl可连接如何解决？

问题重现 #

通过curl可正常连接ES集群，但使用Elasticsearch Python客户端调用ping()时提示连接失败，OpenSearch客户端也出现相同问题，确认auth_token与curl使用的完全一致。

排查与解决方法 #

• 替换认证方式为手动指定headers
  部分版本的Elasticsearch Python客户端对bearer_auth参数的解析可能存在问题，直接用你定义的headers参数传递认证信息（和curl逻辑一致），修改代码如下：

  headers = {"Authorization": f"Bearer {auth_token}"}
  es = Elasticsearch(
      'https://cluster.xyz.com:443',
      headers=headers,
      request_timeout=10,
      verify_certs=False
  )
  if not es.ping():
      raise ValueError("Connection failed")
  

• 开启调试日志对比请求差异
  开启DEBUG日志查看客户端实际发送的请求细节，和curl -v输出的请求做对比，排查头信息、请求路径等是否存在差异：

  import logging
  logging.basicConfig(level=logging.DEBUG)
  
  headers = {"Authorization": f"Bearer {auth_token}"}
  es = Elasticsearch(
      'https://cluster.xyz.com:443',
      headers=headers,
      request_timeout=10,
      verify_certs=False
  )
  es.ping()
  

• 检查客户端与集群版本兼容性
  确保Python客户端版本和ES集群大版本匹配（比如8.x客户端对应8.x集群），跨大版本可能导致协议握手失败。

• 确认代理配置
  如果curl依赖系统代理才能连接集群，Python客户端不会自动继承代理设置，需要手动添加proxies参数：

  headers = {"Authorization": f"Bearer {auth_token}"}
  proxies = {
      'https': 'http://your-proxy-address:port'
  }
  es = Elasticsearch(
      'https://cluster.xyz.com:443',
      headers=headers,
      request_timeout=10,
      verify_certs=False,
      proxies=proxies
  )
  

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