【toc 在这里插入图片描述
】

探索 Python 的 HTTP 世界：为何 `httpx` 是你的新宠？

背景：为何选择 `httpx`？

在现代软件开发中，与 HTTP 服务的交互是家常便饭。无论是调用 RESTful API、进行网络请求还是测试，一个强大且灵活的 HTTP 客户端库都是必不可少的。httpx 正是这样一个库，它不仅支持 HTTP/1.1 和 HTTP/2，还提供了异步请求的能力，让你的代码更加高效。

`httpx` 是什么？

httpx 是一个强大的 HTTP 客户端库，它提供了一个简洁的 API 来发送请求和接收响应。它支持同步和异步请求，可以轻松处理 JSON 数据，并且可以自定义请求和响应的各个方面。

如何安装 `httpx`？

你可以通过 pip 命令轻松安装 httpx：

pip install httpx
1

简单库函数使用方法

发送 GET 请求

import httpx

response = httpx.get('https://api.example.com/data')
print(response.text)
1
2
3
4

import httpx：导入 httpx 库。
httpx.get()：发送一个 GET 请求。
response.text：获取响应的文本内容。

发送 POST 请求

response = httpx.post('https://api.example.com/submit', json={'key': 'value'})
print(response.json())
1
2

httpx.post()：发送一个 POST 请求。
json={'key': 'value'}：将字典序列化为 JSON 并发送。
response.json()：将响应的文本内容解析为 JSON。

处理异常

try:
    response = httpx.get('https://api.example.com/invalid')
except httpx.HTTPError as exc:
    print(f'An error occurred: {exc}')
1
2
3
4

try...except：捕获请求过程中可能发生的异常。

使用 HTTP 基本认证

response = httpx.get('https://api.example.com/secure', auth=('user', 'pass'))
print(response.status_code)
1
2

auth=('user', 'pass')：使用 HTTP 基本认证。

发送带有自定义头部的请求

headers = {'User-Agent': 'MyApp/1.0'}
response = httpx.get('https://api.example.com/data', headers=headers)
print(response.headers)
1
2
3

headers：定义请求头部。
response.headers：获取响应头部。

场景应用

场景一：异步请求

import httpx
import asyncio

async def fetch(url):
    async with httpx.AsyncClient() as client:
        response = await client.get(url)
        return response.text

async def main():
    data = await fetch('https://api.example.com/data')
    print(data)

asyncio.run(main())
1
2
3
4
5
6
7
8
9
10
11
12
13

使用 async with 管理异步客户端的生命周期。
await client.get(url)：异步发送 GET 请求。

场景二：处理 JSON 数据

response = httpx.get('https://api.example.com/data')
data = response.json()
print(data['key'])
1
2
3

response.json()：直接解析响应为 JSON 对象。

场景三：使用会话

with httpx.Client() as client:
    response = client.get('https://api.example.com/data')
    print(response.history)
1
2
3

with httpx.Client()：创建一个会话，可以跨请求保持某些设置。

常见 Bug 及解决方案

Bug 1：连接超时

错误信息：

httpx.TimeoutException: Request timed out after 5.0 seconds.
1

解决方案：

response = httpx.get('https://api.example.com/data', timeout=10.0)
1

timeout=10.0：设置请求超时时间为 10 秒。

Bug 2：SSL 验证失败

错误信息：

httpx.HTTPError: SNI missing on request but required by the server.
1

解决方案：

response = httpx.get('https://api.example.com/data', verify=False)
1

verify=False：禁用 SSL 验证（不推荐在生产环境中使用）。

Bug 3：请求被重定向

错误信息：

httpx.HTTPStatusError: 301 Moved Permanently
1

解决方案：

response = httpx.get('https://api.example.com/data', follow_redirects=True)
1

follow_redirects=True：自动处理重定向。

总结

httpx 是一个功能强大且灵活的 HTTP 客户端库，它支持同步和异步请求，能够满足现代 Web 开发的多种需求。通过本文的介绍，你应该对 httpx 有了深入的了解，并且能够在你的项目中有效地使用它。记住，探索 httpx 的更多功能，将为你的 Python 项目带来无限可能。

如果你觉得文章还不错，请大家点赞、分享、留言下，因为这将是我持续输出更多优质文章的最强动力！

在这里插入图片描述

探索 Python 的 HTTP 世界：为何 `httpx` 是你的新宠？