# 错误：警告：连接断开后重试（Retry(total=4, connect=None, read=None, redirect=None, status=None)），原因为 'ReadTimeoutError'：HTTPSConnectionPool(host='pypi.org', port=443)：读取超时。

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

## 根因

网络延迟或服务器缓慢导致 pip 超过默认读取超时。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |
| 3.12 | active | — | — |

## 解决方案

1. **Increase the default timeout using pip's option** (90% 成功率)
   ```
   pip install --default-timeout=100 mypackage
   ```
2. **Use a faster mirror or proxy** (85% 成功率)
   ```
   pip install -i https://pypi.douban.com/simple mypackage
   ```

## 无效尝试

- **Reducing the timeout value** — A shorter timeout will make the problem worse. (80% 失败率)
- **Using --no-cache-dir** — Caching is not related to network timeout. (70% 失败率)