Skip to content
GGleamInsight
Wiki

Proxy Timeout

A proxy timeout occurs when a client or intermediary stops waiting for a stage of communication. The timeout stage matters: connection establishment, reading, writing, and connection-pool waiting are different failures.

Published 2 min readUpdated

Definition

A proxy timeout occurs when a client or intermediary stops waiting for a stage of communication. The timeout stage matters: connection establishment, reading, writing, and connection-pool waiting are different failures.

Name the timed-out stage

HTTPX distinguishes connect, read, write, and pool timeouts. Connect timeout concerns establishing a socket; read and write timeouts concern waiting for data chunks; pool timeout concerns acquiring a connection. These definitions should not be silently applied to every other client library.

A read timeout is not necessarily a maximum duration for the entire download. If a library measures inactivity between chunks, a transfer can last longer than that value while continuing to make progress. Check whether your chosen option is per-stage, inactivity-based, or an overall deadline.

Separate exceptions from HTTP responses

A client exception can occur without any HTTP response arriving. By contrast, 504 is an HTTP response from a gateway or proxy reporting that it did not receive a timely upstream response. The two observations may have related causes, but they are not interchangeable evidence.

For an illustrative case, the client may stop waiting before a gateway reaches its own upstream deadline. Increasing the client timeout could reveal the eventual gateway response, but does not itself repair the upstream delay.

Use bounded diagnosis

Record the stage, destination, time, and relevant non-secret connection settings. Check whether the client is waiting for local capacity, connecting to the proxy, or waiting for data beyond it. This narrows the investigation without automatically blaming the exit IP.

Choose deadlines that fit the task and a bounded retry policy. Disabling all timeouts can leave workers occupied indefinitely; repeatedly increasing them can hide a stalled dependency rather than resolve it.

Sources

Sources checked on November 18, 2026. Examples are illustrative, not measurements of a live proxy service.

Frequently asked questions

Does timeout prove an IP was blocked?

No. Many stages can time out, including waiting for a local connection-pool slot.

Is a read timeout always a total request deadline?

No. In HTTPX it is a maximum wait for a data chunk. Other clients require their own documentation.

Is every timeout an HTTP 504?

No. A client-side timeout can happen without receiving an HTTP response.