如何运行Elasticsearch Python单元测试？测试执行失败求助

我来帮你定位下这个问题，结合elasticsearch-py 5.x版本的特性和常见的测试踩坑点，给你几个具体的排查方向：

• 检查容器内ES的网络可达性
  先确认测试代码有没有用对容器的访问地址：

  • 在宿主机执行curl http://<容器IP>:9200，看看能不能正常返回ES的集群信息。5.x版本默认用9200端口，且无安全验证（默认配置下）。
  • 如果是用Docker Compose启动的ES，要注意测试代码是否使用了服务名作为主机名（仅在容器网络内有效），如果是宿主机跑测试，得用容器映射到宿主机的IP和端口。

• 确认requests库版本兼容性
  elasticsearch-py 5.x对requests库有明确的版本兼容要求，太新或太旧的requests都可能导致连接测试失败：

  • 5.x分支要求requests>=2.4.0，但建议不要用3.x版本的requests（和5.x客户端不兼容），可以尝试安装requests==2.26.0这个稳定兼容版本。
  • 执行pip list | grep requests查看当前版本，确认是否在兼容范围内。

• 排查测试环境的代理干扰
  如果你的宿主机或测试环境配置了HTTP/HTTPS代理，TestRequestsConnection可能会走代理去连接ES，导致无法访问容器内服务：

  • 跑测试前临时取消代理：

    unset HTTP_PROXY
    unset HTTPS_PROXY
    

  • 或者在测试代码的连接配置里显式禁用代理：

    from elasticsearch import Elasticsearch
    es = Elasticsearch(["http://<容器IP>:9200"], proxies={"http": None, "https": None})
    

• 查看ES容器日志，确认服务状态
  有时候容器看似启动成功，但ES可能未完全初始化或存在配置错误：

  • 执行docker logs <容器ID/名称>查看日志，确认是否出现started关键字，排查是否有权限错误、虚拟内存不足等问题（5.x版本要求系统vm.max_map_count=262144，如果没设置，日志会有相关提示）。

• 检查测试代码的连接配置
  确认TestRequestsConnection类中的连接参数是否正确：

  • 看看测试用例是不是硬编码了localhost:9200，但容器映射的端口不是9200，或者容器使用了自定义网络导致宿主机无法通过localhost访问。
  • 可以在测试代码中显式指定ES地址，验证连接是否正常。

• 确认ES是否启用安全特性
  虽然5.x默认不启用安全验证，但如果启动容器时手动开启了X-Pack（比如挂载了自定义配置或设置了ELASTIC_PASSWORD环境变量），测试连接需要带上认证信息：

  • 在测试代码中添加http_auth=("elastic", "你的密码")参数，再尝试运行测试。

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