Elasticsearch首次部署主机名配置问题：Python客户端连接失败

问题根源分析 #

你遇到的socket.gaierror: [Errno -3] Temporary failure in name resolution错误，核心原因是host参数包含了https://协议头，客户端会把整个字符串当作域名去解析，导致DNS无法识别。另外，Elastic Cloud的ES服务默认端口不是本地常用的9200，这也是配置错误点。

修正步骤 #

1. 修正Host参数格式 #

host字段只需要纯主机名，去掉开头的https://，比如把https://my-first-deployment.es.southamerica-east1.gcp.elastic-cloud.com改为my-first-deployment.es.southamerica-east1.gcp.elastic-cloud.com。

2. 使用正确的端口 #

Elastic Cloud的ES服务默认HTTPS端口是9243，而非本地的9200。你也可以在Elastic Cloud控制台确认正确端口：

• 登录Elastic Cloud控制台，找到你的部署
• 进入部署详情页，在「Endpoints」或「Overview」区域，查看Elasticsearch的完整连接地址，格式类似https://xxx.es.xxx.gcp.elastic-cloud.com:9243，冒号后的数字就是正确端口。

3. 补充认证信息（必填） #

Elastic Cloud部署默认开启安全认证，必须提供用户名（默认是elastic）和部署时设置的密码，否则即使连接成功也无法执行操作。

修正后的完整代码 #

from elasticsearch import Elasticsearch

client = Elasticsearch(
    hosts=["my-first-deployment.es.southamerica-east1.gcp.elastic-cloud.com"],
    port=9243,
    scheme="https",
    http_auth=("elastic", "your_deployment_password")
)

# 测试连接有效性
if client.ping():
    print("Elasticsearch连接成功")
else:
    print("Elasticsearch连接失败")

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