Elasticsearch无法通过Python客户端连接：SSL主机名不匹配错误

问题根源 #

报错信息明确指出：你使用的Elasticsearch SSL证书中包含的主机名（localhost、172.19.0.2、127.0.0.1、bde723133f75）与实际连接的外部服务器IP（34.116.***.***）不匹配。浏览器或Postman可能默认跳过了严格的主机名校验，而Python Elasticsearch客户端会强制执行该校验，导致连接失败。

可行解决方案 #

方案1：重新生成包含外部IP/域名的SSL证书（生产环境推荐） #

这是最安全合规的做法：

• 重新生成Elasticsearch的SSL证书，将你的外部服务器IP或域名添加到证书的**Subject Alternative Names（SANs）**字段中
• 替换服务器上的旧证书，重启Elasticsearch服务
• 更新Python客户端使用的CA证书为新生成的根证书

方案2：临时关闭主机名校验（仅测试环境使用） #

如果只是临时测试需求，可以在连接时禁用主机名验证（生产环境禁止使用）：

self.es = Elasticsearch(
    address,
    ca_certs=cert_path,
    basic_auth=(user, password),
    ssl_assert_hostname=False,
    ssl_show_warn=False
)

或者通过transport_options配置：

self.es = Elasticsearch(
    address,
    ca_certs=cert_path,
    basic_auth=(user, password),
    transport_options={
        "ssl": {
            "assert_hostname": False
        }
    }
)

方案3：本地hosts映射（测试环境可选） #

如果证书中包含某个主机名（比如localhost），可以在本地机器的hosts文件中添加映射：

Windows路径：C:\Windows\System32\drivers\etc\hosts
Linux/macOS路径：/etc/hosts
添加内容：34.116.***.*** localhost

之后Python代码中使用localhost作为连接地址即可。

内容的提问来源于stack exchange，提问作者Michał Bogusz