ConnectionError: Connection Timed Out

requests.exceptions.ConnectTimeout: Max retries exceeded (connect timeout)

Quick Answer

The server did not respond in time. Increase timeout, add retries with backoff, or check network connectivity.

Why This Happens

Connection timeouts occur when the server does not respond within the allotted time. Always set explicit timeouts to prevent indefinite hanging.

The Problem

import requests
response = requests.get('https://api.example.com')

The Fix

import requests
from requests.adapters import HTTPAdapter, Retry

session = requests.Session()
retries = Retry(total=3, backoff_factor=0.5)
session.mount('https://', HTTPAdapter(max_retries=retries))

try:
    response = session.get('https://api.example.com', timeout=10)
except requests.exceptions.Timeout:
    print('Request timed out')

Step-by-Step Fix

  1. 1

    Set explicit timeouts

    Always pass timeout=seconds to requests.

  2. 2

    Add retry logic

    Use Retry with exponential backoff.

  3. 3

    Check network

    Verify DNS and network access to the target.

Bugsly catches this automatically

Bugsly's AI analyzes this error pattern in real-time, explains what went wrong in plain English, and suggests the exact fix — before your users even report it.

Try Bugsly free