python network_error ai_generated true

ERROR: WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError': HTTPSConnectionPool(host='pypi.org', port=443): Read timed out.

ID: python/pip-download-timeout

Also available as: JSON · Markdown · 中文
80%Fix Rate
85%Confidence
0Evidence
2026-01-15First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.8 active — — —
3.9 active — — —
3.10 active — — —
3.11 active — — —
3.12 active — — —

Root Cause

Network latency or server slowness causes pip to exceed the default read timeout.

generic

中文

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

Workarounds

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

Dead Ends

Common approaches that don't work:

  1. Reducing the timeout value 80% fail

    A shorter timeout will make the problem worse.

  2. Using --no-cache-dir 70% fail

    Caching is not related to network timeout.