python httpx async客戶端示例

使用httpx.AsyncClient可高效发起异步HTTP请求，1. 基本GET请求通过async with管理客户端并用await client.get发起非阻塞请求；2. 并发多个请求时结合asyncio.gather可显著提升性能，总耗时等于最慢请求；3. 支持自定义headers、认证、base_url和超时设置；4. 可发送POST请求并携带JSON数据；5. 注意避免混用同步异步代码，代理支持需注意后端兼容性，适合用于爬虫或API聚合等场景。

下面是一个使用 httpx 的异步客户端（AsyncClient）的实用示例，适合在异步 Python 项目中发起 HTTP 请求（比如配合 fastapi、asyncio 等使用）。

✅ 基本异步 GET 请求示例

import asyncio
import httpx

async def fetch_data():
    async with httpx.AsyncClient() as client:
        response = await client.get("https://httpbin.org/get")
        print(response.status_code)
        print(response.json())

# 运行异步函数
asyncio.run(fetch_data())

? 说明：

• 使用 async with httpx.AsyncClient() 确保连接被正确管理（自动关闭）。
• await client.get(...) 发起异步请求，不会阻塞事件循环。

? 并发多个请求（更高效）

如果你想同时请求多个 URL，可以配合 asyncio.gather 提高性能：

import asyncio
import httpx

async def fetch_url(client: httpx.AsyncClient, url: str):
    response = await client.get(url)
    return response.json()["url"]  # 返回请求的 URL 作为示例

async def fetch_all():
    async with httpx.AsyncClient() as client:
        tasks = [
            fetch_url(client, "https://httpbin.org/delay/1"),
            fetch_url(client, "https://httpbin.org/delay/2"),
            fetch_url(client, "https://httpbin.org/get"),
        ]
        results = await asyncio.gather(*tasks)
        for result in results:
            print(result)

asyncio.run(fetch_all())

⏱️ 这三个请求是并发执行的，总耗时 ≈ 最慢的那个（约 2 秒），而不是累加。

? 带认证和自定义头的请求

import asyncio
import httpx

async def authenticated_request():
    headers = {
        "Authorization": "Bearer your-token-here",
        "User-Agent": "MyApp/1.0"
    }
    async with httpx.AsyncClient(headers=headers) as client:
        response = await client.get("https://httpbin.org/bearer")
        print(response.json())

asyncio.run(authenticated_request())

你也可以在 AsyncClient 中设置 base URL、超时、cookies 等：

client = httpx.AsyncClient(
    base_url="https://api.example.com",
    headers={"Authorization": "Bearer xyz"},
    timeout=10.0
)

? POST 请求示例（发送 JSON）

import asyncio
import httpx

async def post_data():
    async with httpx.AsyncClient() as client:
        data = {"name": "Alice", "age": 30}
        response = await client.post("https://httpbin.org/post", json=data)
        print(response.json()["json"])

asyncio.run(post_data())

⚠️ 注意事项

• httpx.AsyncClient 是基于异步后端（如 httpcore）的，底层使用 asyncio 或 trio。
• 不要混用同步和异步调用。
• 如果你需要代理支持，可以传入 proxies 参数（部分异步代理需使用 trio 后端）：

  client = httpx.AsyncClient(proxies="http://localhost:8080")

  ---

  基本上就这些。对于大多数异步 Python 服务（如爬虫、API 聚合器），httpx.AsyncClient 都是非常高效且易用的选择。

  以上是python httpx async客戶端示例的詳細內容。更多資訊請關注PHP中文網其他相關文章！