**问题解构**：YOLOv5与Python 3.8运行时出现的`urllib3`版本冲突错误，通常源于YOLOv5项目所依赖的包（如`requests`、`aiohttp`、`ultralytics`等）对`urllib3`有特定的版本要求，而系统中已安装的`urllib3`版本与之不兼容[ref_2]。Python 3.8环境下，较新的`urllib3`版本（如2.x系列）可能与YOLOv5依赖的某些旧版库存在接口或行为变更，导致冲突。 **方案推演**：解决此问题的核心是**精确管理`urllib3`的版本**，使其满足YOLOv5及其所有间接依赖的要求。最佳实践是在一个独立的虚拟环境中，使用项目提供的依赖文件进行安装，若仍存在冲突，则进行针对性的版本降级或升级。 ### **解决方案与具体步骤** #### **1. 创建并激活独立的虚拟环境** 强烈建议为YOLOv5项目创建独立的Python虚拟环境，以避免与系统或其他项目的包版本冲突。 ```bash # 使用conda创建虚拟环境（假设已安装Anaconda或Miniconda） conda create -n yolov5_env python=3.8 -y conda activate yolov5_env # 或者使用venv创建虚拟环境 python3.8 -m venv yolov5_env source yolov5_env/bin/activate # Linux/macOS # yolov5_env\Scripts\activate # Windows ``` #### **2. 安装YOLOv5及其依赖** 首先克隆YOLOv5官方仓库并尝试使用其推荐的依赖文件安装。 ```bash # 克隆YOLOv5仓库（以v6.0版本为例，可根据需要选择其他分支） git clone https://github.com/ultralytics/yolov5.git cd yolov5 # 使用requirements.txt安装依赖（此文件通常定义了兼容的版本范围） pip install -r requirements.txt ``` 如果`requirements.txt`中未明确指定`urllib3`版本，或安装后仍报错，进入下一步。 #### **3. 诊断并解决urllib3版本冲突** 首先检查当前环境中`urllib3`的版本以及是哪个包引入了不兼容的版本。 ```bash # 查看已安装的urllib3版本 pip show urllib3 # 检查哪些包依赖于urllib3及其版本要求 pipdeptree | grep -i urllib3 ``` 根据常见的YOLOv5兼容性经验，`urllib3`版本冲突通常可通过以下两种方式解决： **方案A：降级urllib3至兼容版本** 对于较早期的YOLOv5版本（如v5.x），其依赖的`requests`等库可能与`urllib3` 2.x不兼容。将其降级至1.x系列。 ```bash # 降级urllib3至1.26.x系列（一个广泛兼容的版本） pip install "urllib3<2.0" --upgrade ``` **方案B：升级相关依赖以适配新版urllib3** 如果YOLOv5版本较新，可能需要升级其他依赖（如`requests`、`aiohttp`）来适配`urllib3` 2.x。 ```bash # 升级requests和aiohttp到较新版本 pip install --upgrade requests aiohttp # 如果使用ultralytics包（YOLOv8官方，但有时YOLOv5环境也会混用） pip install --upgrade ultralytics ``` #### **4. 验证安装与基本运行** 安装完成后，进行快速验证。 ```bash # 再次确认urllib3版本 python -c "import urllib3; print(urllib3.__version__)" # 运行一个简单的YOLOv5推理测试，确保核心功能正常 python detect.py --source data/images/bus.jpg --weights yolov5s.pt --conf 0.25 ``` 如果上述命令能成功下载预训练权重（若本地没有）并输出检测结果，则表明环境配置成功[ref_3][ref_5]。 #### **5. 常见关联问题与处理** 有时`urllib3`版本错误会与网络代理、SSL证书等问题交织出现。 | 关联问题 | 表现 | 解决方案 | | :--- | :--- | :--- | | **SSL证书验证失败** | 报错包含`SSLError`, `CERTIFICATE_VERIFY_FAILED` | `pip install --upgrade certifi` 或运行代码前设置 `import ssl; ssl._create_default_https_context = ssl._create_unverified_context`（仅测试环境）[ref_4]。 | | **requests库版本过低** | 与`urllib3`新版不兼容，引发`AttributeError` | 升级requests: `pip install --upgrade requests`。 | | **依赖文件未覆盖** | 项目自有的`requirements.txt`未包含全部子模块的依赖 | 检查项目是否有额外的`requirements_*.txt`文件（如`requirements_core.txt`），并一并安装。 | **总结**：解决YOLOv5在Python 3.8下的`urllib3`版本冲突，关键在于**隔离环境**和**精确控制版本**。优先在虚拟环境中使用项目原生的`requirements.txt`安装。若仍报错，根据错误信息将`urllib3`降级至`1.26.x`或升级其上层依赖（如`requests`）通常是有效的解决路径[ref_2]。在整个过程中，使用`pipdeptree`等工具理清依赖关系，可以避免盲目操作。