Unable to connect to API: SSL certificate hostname mismatch

🔍 错误分析：SSL证书主机名不匹配

#### 1. 🌐 错误翻译

原文：Unable to connect to API: SSL certificate hostname mismatch
译文：无法连接到API：SSL证书主机名不匹配

#### 2. 🎯 原因分析
根本原因：客户端发起HTTPS请求时，目标服务器提供的SSL/TLS证书中声明的域名（Common Name或Subject Alternative Names） 与客户端实际连接的主机名不一致。
具体场景：例如，客户端请求 https://api.new-service.com，但服务器返回的证书是为 api.old-service.com 颁发的，或者证书是自签名的通用名称。
安全机制：这是客户端（如浏览器、HTTP库）出于安全考虑自动执行的验证步骤，用于防止中间人攻击。

#### 3. 💡 解决方案
请按顺序尝试以下步骤：

第一步：核对客户端配置
检查你的代码或配置文件中，API的基础URL（Base URL） 是否书写正确。

# 例如，在你的代码或配置文件中查找类似内容，并确保域名完全正确
grep -r “api.example.com” .
# 或
grep -r “https://” ./config/

第二步：临时诊断（仅用于开发/测试）
⚠️ 警告：此方法禁用安全验证，存在安全风险，切勿在生产环境使用。
在你的HTTP客户端代码中临时关闭主机名验证，以确认问题是否仅由此引起。

# Python (requests库) 示例
import requests

requests.packages.urllib3.disable_warnings() # 可选，用于禁用警告
response = requests.get(
    “https://your-api-endpoint.com”,
    verify=False  # 不验证SSL证书
)
print(response.text)

// Node.js (axios库) 示例
const axios = require(‘axios’);
const agent = new https.Agent({
    rejectUnauthorized: false // 禁用证书验证
});
axios.get(‘https://your-api-endpoint.com’, { httpsAgent: agent })
    .then(response => console.log(response.data));

第三步：根本修复（生产环境必须）
方法A：确保域名一致。联系API提供方，确认你请求的域名是其证书涵盖的有效域名。
方法B：更换为证书匹配的域名。如果API有备用域名或IP，请使用证书中包含的域名或IP进行访问。
方法C：安装/信任正确证书。如果使用的是自签名或内部CA颁发的证书，你需要将该根证书（CA） 添加到你客户端运行环境的信任存储中。
系统级：将证书文件（如 .pem, .crt）导入操作系统受信任的根证书颁发机构。
应用级：在代码中为HTTP客户端指定证书路径。

    # Python requests 使用自定义CA证书包
    response = requests.get(‘https://internal-api.com’, verify=‘/path/to/custom-ca-bundle.crt’)
    

#### 4. 🛡️ 预防措施