# 错误：异常：
回溯（最近调用最后）：
  ...
pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): 读取超时。

- **ID:** `python/pip-read-timeout-pypi`
- **领域:** python
- **类别:** network_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

到 files.pythonhosted.org 的网络连接过慢或不稳定，导致 pip 的默认读取超时在 wheel 下载完成前就已耗尽。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.x | active | — | — |

## 解决方案

1. **** (90% 成功率)
   ```
   Run pip install --timeout 120 <pkg>, or set PIP_DEFAULT_TIMEOUT=120 in the environment.
   ```
2. **** (93% 成功率)
   ```
   Run pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <pkg> (or another regional mirror).
   ```
3. **** (88% 成功率)
   ```
   Use curl -O https://files.pythonhosted.org/.../pkg.whl then pip install ./pkg.whl.
   ```

## 无效尝试

- **** — Retries help with transient failures but do not extend the per-read timeout. (70% 失败率)
- **** — Cache is unrelated to network timeout. (90% 失败率)
- **** — Prereleases do not fix network latency. (95% 失败率)