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

【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

简单库函数使用方法

发送 GET 请求

import httpx

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

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

发送 POST 请求

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

• 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}')

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

使用 HTTP 基本认证

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

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

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

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

• 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())

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

场景二：处理 JSON 数据

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

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

场景三：使用会话

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

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

常见 Bug 及解决方案

Bug 1：连接超时

错误信息：

httpx.TimeoutException: Request timed out after 5.0 seconds.

解决方案：

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

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

Bug 2：SSL 验证失败

错误信息：

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

解决方案：

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

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

Bug 3：请求被重定向

错误信息：

httpx.HTTPStatusError: 301 Moved Permanently

解决方案：

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

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

总结

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

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