Что такое ASGI?

Контракт приложения

ASGI-приложение — это async callable с тремя аргументами:

async def app(scope, receive, send):
    ...

• scope: dict — метаданные соединения: type ("http", "websocket", "lifespan"), method, path, headers, client, server и т. д.
• receive: Callable[[], Awaitable[dict]] — корутина, возвращающая входящие события (request body chunks, WebSocket-сообщения, disconnect).
• send: Callable[[dict], Awaitable[None]] — корутина для отправки событий ответа (start, body, websocket.accept и т. д.).

Определение

ASGI — Asynchronous Server Gateway Interface, спецификация (asgi.readthedocs.io) интерфейса между async-совместимым web-сервером и Python-приложением. Это преемник WSGI, разработанный командой Django Channels и поддерживаемый Starlette, FastAPI, Django (с 3.0), Quart, Sanic, BlackSheep и другими.

Минимальное HTTP-приложение

async def app(scope, receive, send):
    assert scope["type"] == "http"
    # Прочитать тело
    body = b""
    more = True
    while more:
        msg = await receive()
        body += msg.get("body", b"")
        more = msg.get("more_body", False)
    # Отправить ответ
    await send({
        "type": "http.response.start",
        "status": 200,
        "headers": [(b"content-type", b"text/plain; charset=utf-8")],
    })
    await send({
        "type": "http.response.body",
        "body": b"Hello from ASGI",
    })

Запуск: uvicorn module:app --host 0.0.0.0 --port 8000.

Поддерживаемые протоколы

• http — обычные запросы, с поддержкой streaming request/response через несколько http.response.body-событий.
• websocket — события websocket.connect, websocket.receive, websocket.send, websocket.disconnect.
• lifespan — startup/shutdown сообщения от сервера приложению (там удобно открывать DB-пул, прогревать кэш).

Серверы и фреймворки

• Серверы (реализуют протокол): Uvicorn (на uvloop+httptools), Hypercorn (поддерживает HTTP/2 и HTTP/3), Daphne (от Django Channels), Granian.
• Фреймворки (пишут логику поверх ASGI): Starlette, FastAPI, Django, Quart, Litestar.
• Middleware: оборачивает ASGI app в другой ASGI app — например, CORSMiddleware, GZipMiddleware, SessionMiddleware.

Подводные камни

• ASGI не делает blocking-код автоматически быстрым: requests, psycopg2, time.sleep внутри async def блокируют event loop и убивают параллелизм. Используйте httpx.AsyncClient, asyncpg/psycopg[async], asyncio.sleep или выносите blocking-вызовы в asyncio.to_thread/run_in_executor.
• Путать ASGI-сервер (Uvicorn) и фреймворк (FastAPI). Uvicorn умеет запускать любое ASGI-приложение, не только FastAPI.
• Забывать про lifespan: ресурсы, открытые на module-level, не закроются корректно при graceful shutdown.
• Использовать sync WSGI-middleware в ASGI-стеке — нужен ASGI-нативный middleware или адаптер WSGIMiddleware.
• Не настраивать --workers/--loop uvloop в проде — один процесс не использует все ядра.

• Описывать ASGI как WSGI с async def только по названию.
• Не знать scope/receive/send.
• Не упоминать WebSocket.

• Называет ASGI callable contract.
• Понимает HTTP/WebSocket support.
• Знает uvicorn/hypercorn роль.