HTTP asíncrono con httpx/aiohttp

httpx (recomendado para pilas de la era FastAPI) y aiohttp proporcionan clientes HTTP asíncronos con pooling de conexiones, tiempos de espera y solicitudes concurrentes. Comparte una instancia de cliente por ciclo de vida de la aplicación, no por solicitud.

Receta

import asyncio
import httpx
 
async def main() -> None:
    async with httpx.AsyncClient(timeout=10.0) as client:
        r = await client.get("https://httpbin.org/get")
        print(r.status_code)
 
asyncio.run(main())

Cuándo usar esto:

• Agregación de API de tipo "fan-out" en rutas de FastAPI
• Entrega de webhooks y reintentos
• Llamadas de servicio a servicio bajo carga
• Descargas/cargas en streaming
• Reemplazo de requests bloqueantes en aplicaciones asíncronas

Ejemplo funcional

import asyncio
import httpx
 
URLS = [
    "https://httpbin.org/delay/0.1",
    "https://httpbin.org/status/200",
    "https://httpbin.org/uuid",
]
 
async def fetch_all(client: httpx.AsyncClient, urls: list[str]) -> list[int]:
    async def one(url: str

Lo que esto demuestra:

• AsyncClient compartido reutiliza conexiones TCP (keep-alive)
• Limits limita las conexiones concurrentes por host
• raise_for_status convierte 4xx/5xx en excepciones
• gather superpone esperas de red en un solo bucle

Profundización

httpx vs aiohttp

Ciclo de vida del cliente

• Crear al inicio de la aplicación (vida útil de FastAPI)
• Cerrar al apagar para vaciar los pools
• Un cliente por hilo del bucle de eventos

Errores comunes

• Nuevo cliente por solicitud - destruye el pooling, agota los sockets. Solución: singleton a nivel de aplicación.
• Sin tiempos de espera - corrutinas colgadas para siempre. Solución: tiempo de espera predeterminado en el cliente y anulación por llamada.
• httpx síncrono en ruta asíncrona - bloquea el bucle. Solución: usar solo AsyncClient en corrutinas.
• SSL/configuración incorrecta de proxy de entorno - funciona en desarrollo, falla en producción. Solución: trust_env y certificados explícitos.
• gather sin límites a APIs lentas - sobrecarga al par y a uno mismo. Solución: semáforo para limitar la concurrencia.

Alternativas

Preguntas frecuentes

Relacionado

• Tareas y Gather - fetches concurrentes
• Puente Síncrono/Asíncrono - evitar solicitudes síncronas
• Reintentos y Backoff - política de reintentos
• Fundamentos de Asyncio - fundamentos del bucle

Versiones de la pila: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+ y uv 0.6+.