f8981f3d12
* Add the proxy parameter and deprecate proxies * Make the Client.proxy and HTTPTransport.proxy types the same * Update httpx/_transports/default.py Co-authored-by: T-256 <132141463+T-256@users.noreply.github.com> * Update httpx/_transports/default.py Co-authored-by: T-256 <132141463+T-256@users.noreply.github.com> * Drop unneeded noqa * Changelog * update documentation * Allow None in mounts * typos * Update httpx/_types.py * Changes proxies to proxy in CLI app * Add proxy to request function * Update CHANGELOG.md Co-authored-by: Tom Christie <tom@tomchristie.com> * Update docs/troubleshooting.md Co-authored-by: Tom Christie <tom@tomchristie.com> * Update docs/troubleshooting.md Co-authored-by: Tom Christie <tom@tomchristie.com> * Lint --------- Co-authored-by: Tom Christie <tom@tomchristie.com> Co-authored-by: T-256 <132141463+T-256@users.noreply.github.com>
2.1 KiB
Troubleshooting
This page lists some common problems or issues you could encounter while developing with HTTPX, as well as possible solutions.
Proxies
"The handshake operation timed out" on HTTPS requests when using a proxy
Description: When using a proxy and making an HTTPS request, you see an exception looking like this:
httpx.ProxyError: _ssl.c:1091: The handshake operation timed out
Similar issues: encode/httpx#1412, encode/httpx#1433
Resolution: it is likely that you've set up your proxies like this...
mounts = {
"http://": httpx.HTTPTransport(proxy="http://myproxy.org"),
"https://": httpx.HTTPTransport(proxy="https://myproxy.org"),
}
Using this setup, you're telling HTTPX to connect to the proxy using HTTP for HTTP requests, and using HTTPS for HTTPS requests.
But if you get the error above, it is likely that your proxy doesn't support connecting via HTTPS. Don't worry: that's a common gotcha.
Change the scheme of your HTTPS proxy to http://... instead of https://...:
mounts = {
"http://": httpx.HTTPTransport(proxy="http://myproxy.org"),
"https://": httpx.HTTPTransport(proxy="http://myproxy.org"),
}
This can be simplified to:
proxy = "http://myproxy.org"
with httpx.Client(proxy=proxy) as client:
...
For more information, see Proxies: FORWARD vs TUNNEL.
Error when making requests to an HTTPS proxy
Description: your proxy does support connecting via HTTPS, but you are seeing errors along the lines of...
httpx.ProxyError: [SSL: PRE_MAC_LENGTH_TOO_LONG] invalid alert (_ssl.c:1091)
Similar issues: encode/httpx#1424.
Resolution: HTTPX does not properly support HTTPS proxies at this time. If that's something you're interested in having, please see encode/httpx#1434 and consider lending a hand there.