这个错误： ``` TypeError("HTTPSConnection.__init__() got an unexpected keyword argument 'check_hostname'") ``` **不是 Vue 相关错误**，而是 **Python 标准库 `http.client` 或底层 `urllib3` / `requests` 在低版本 Python 中与高版本 SSL 库不兼容导致的**。它通常出现在使用 `requests`、`urllib`、`botocore`、`boto3`、`pip`、或某些 SDK（如阿里云/腾讯云 SDK）时，**与 Vue 完全无关**。 但既然你在 Vue 项目上下文中遇到它，极大概率是以下场景之一： ✅ **你正在用 Python 编写一个 Vue 项目的后端（如 Flask/FastAPI/Django），并在后端代码中调用了 HTTPS 请求；** ✅ **你在本地运行 `npm run dev` 时，同时启用了 Python 脚本（如 mock server、数据同步脚本、CI 工具），该脚本触发了此异常；** ✅ **你误将 Python 错误日志粘贴到了 Vue 问题中（常见于全栈开发者）。** --- ### 🔍 错误根源分析 `check_hostname` 是 Python 的 `ssl.SSLContext` 和 `http.client.HTTPSConnection` 在 **Python 2.7.9+ / 3.2+** 中引入的安全参数，用于控制是否验证服务器证书中的 hostname（即防止中间人攻击）。 但该参数**首次出现在 `HTTPSConnection` 构造函数中是在 Python 2.7.9 和 3.4.3+**。如果你看到这个错误，说明： | 原因 | 具体表现 | |------|-----------| | ❌ **Python 版本过低**（如 Python 2.7.6、2.7.8、3.3.x 或更早） | `HTTPSConnection.__init__()` 尚未支持 `check_hostname` 参数，但某第三方库（如 `urllib3 >= 1.26`、`requests >= 2.26`）却传入了它 → `TypeError` | | ❌ **混合了不兼容的 urllib3 / requests 版本** | 例如：`urllib3==1.26.15`（要求 Python ≥3.6）被强行安装在 Python 3.4 上 | | ❌ **自定义 `HTTPSConnection` 子类或 monkey patch 冲突** | 某 SDK（如旧版 `aliyun-python-sdk-core`）手动 patch 了连接类，但未适配新参数 | > ✅ 验证你的 Python 版本： > ```bash > python --version > # 若输出为 Python 2.7.8、Python 3.3.7、Python 3.4.2 等，就是根本原因！ > ``` --- ### ✅ 解决方案（按优先级排序） #### ✅ 方案 1：升级 Python（**最推荐、一劳永逸**） ```bash # macOS（推荐用 pyenv） pyenv install 3.11.9 pyenv global 3.11.9 # Ubuntu/Debian sudo apt update && sudo apt install python3.11 python3.11-venv # Windows：从 https://www.python.org/downloads/ 下载安装 Python 3.11+ ``` > ✅ Python 3.11+ 完全支持 `check_hostname=True/False`，且是当前主流 LTS 版本。 #### ✅ 方案 2：降级不兼容的依赖（临时应急） 如果**无法升级 Python**（如嵌入式环境、老旧服务器），则需锁定兼容版本： ```bash # 卸载高版本 urllib3/requests pip uninstall urllib3 requests -y # 安装已知兼容的旧版本（以 Python 2.7.8 为例） pip install "urllib3<1.25" "requests<2.22" ``` | Python 版本 | 推荐 `urllib3` 版本 | 推荐 `requests` 版本 | |-------------|------------------------|--------------------------| | Python 2.7.6–2.7.8 | `urllib3<1.23` | `requests<2.19` | | Python 3.3.x | `urllib3<1.24` | `requests<2.20` | | Python 3.4.2 | `urllib3<1.25` | `requests<2.22` | > 📌 查证依据：[urllib3 Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst) 明确标注 `1.25` 开始 require Python ≥3.4.3。 #### ✅ 方案 3：修复 monkey patch（针对特定 SDK） 例如阿里云旧版 SDK（`aliyun-python-sdk-core<2.13.31`）会 patch `HTTPSConnection` 但忽略 `check_hostname`。解决： ```bash pip install --upgrade aliyun-python-sdk-core>=2.13.31 # 或彻底迁移到新版阿里云 SDK：aliyun-openapi-python-sdk ``` #### ✅ 方案 4：检查是否误用了 `ssl._create_unverified_context` 某些 hack 代码会这样写（危险且过时）： ```python import ssl from http.client import HTTPSConnection context = ssl._create_unverified_context() conn = HTTPSConnection("example.com", context=context) # ❌ 无 check_hostname 参数 ``` → 应改为标准方式： ```python import ssl from http.client import HTTPSConnection context = ssl.create_default_context() # ✅ 自动启用 check_hostname=True conn = HTTPSConnection("example.com", context=context) ``` --- ### 🧪 快速诊断脚本（复制即用） 将以下内容保存为 `check_ssl.py`，运行 `python check_ssl.py`： ```python import sys import ssl from http.client import HTTPSConnection print("Python version:", sys.version) print("SSL version:", ssl.OPENSSL_VERSION) try: # 尝试构造带 check_hostname 的连接（模拟 requests 行为） conn = HTTPSConnection("httpbin.org", check_hostname=True) print("✅ check_hostname is supported") except TypeError as e: print("❌ check_hostname NOT supported:", e) except Exception as e: print("Other error:", e) ``` --- ### ⚠️ 重要提醒（Vue 开发者必看） | 场景 | 是否 Vue 问题？ | 应对方式 | |------|------------------|------------| | 在 `.vue` 文件里写 `:key="item.name || item.key"` 报这个错 | ❌ 绝不可能（Vue 运行在浏览器 JS 引擎，不涉及 Python `HTTPSConnection`） | 检查你是否在终端/IDE 底部误读了**后端 Python 进程的日志** | | `npm run dev` 启动时终端突然抛出此错误 | ❌ 不是 Vue CLI 错误，而是你同时运行的 Python 后端/脚本崩溃了 | `ps aux \| grep python` 找出并 kill 冲突进程 | | 使用 Vite 插件（如 `vite-plugin-mock`）时出现 | ❌ 插件本身是 JS，但若你配置了 `serve` 代理到 Python 服务，而该服务报错 → 错误源头仍在 Python | 检查 `vite.config.ts` 中 `server.proxy` 指向的服务是否健康 | ---