# WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7f...>: Failed to establish a new connection: [Errno 110] Connection timed out')': /simple/package/

- **ID:** `python/pip-connection-timeout`
- **Domain:** python
- **Category:** network_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

Network issues prevent pip from reaching PyPI; firewall, proxy, or DNS problems.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.10 | active | — | — |

## Workarounds

1. **Use a mirror or alternative index** (90% success)
   ```
   pip install package -i https://pypi.douban.com/simple/
   ```
2. **Configure proxy if behind firewall** (85% success)
   ```
   pip install package --proxy http://user:pass@proxy:port
   ```

## Dead Ends

- **Increasing pip timeout with --timeout=100** — Timeout extension doesn't fix underlying network connectivity. (70% fail)
- **Using --no-cache-dir** — Cache is not the issue; network still unreachable. (80% fail)