Lingua-e
Python

What is a TimeoutError?

← Errors

TimeoutError is raised when a socket or I/O operation exceeds the time limit set by a timeout. It is a subclass of OSError. Many third-party libraries (requests, httpx, asyncio) wrap this as their own timeout exception.

Why it happens

  • •A socket.settimeout() value is exceeded before a connection or read completes.
  • •A remote server is overloaded and doesn't respond within the allowed time.
  • •Network congestion or packet loss causes the operation to stall.
  • •The asyncio.wait_for() timeout fires before the coroutine finishes.

Examples

Python

Code that triggers the error

import socket

s = socket.socket()
s.settimeout(2)
s.connect(("10.255.255.1", 80))  # unreachable host

Error output

TimeoutError: timed out

How to fix it

Always set explicit timeouts on network operations rather than waiting indefinitely. Implement retry logic with exponential backoff for transient timeouts. Distinguish between connection timeouts (server unreachable) and read timeouts (server connected but slow to respond).

Fixed code

import socket

s = socket.socket()
s.settimeout(5)
try:
    s.connect(("10.255.255.1", 80))
except TimeoutError:
    print("Connection timed out, host unreachable")
finally:
    s.close()

Related errors

Ready to practice your English at work?

Lingua-e has interactive exercises built around real developer conversations: standups, code reviews, retrospectives, and more. Practice until it comes naturally.

Try Lingua-e for free