如何配置Starlette以支持异步请求

胖杰吖_7759

胖杰吖_7759

2026-11-18

110人浏览

原创

starlette 默认基于 python 的 `asyncio` 事件循环构建,因此原生支持异步请求处理,无需额外安装特殊依赖即可直接使用。要配置 starlette 以支持异步请求,只需在路由定义中使用 `async def` 声明视图函数或类方法,并确保所有 i/o 操作(如数据库查询、http 请求)均使用异步库(如 `httpx`、`aiomysql`)而非同步阻塞库。当请求进入时,starlette 会自动将异步协程挂起并交由事件循环调度,从而实现高并发下的非阻塞处理。

如何配置Starlette以支持异步请求

如何定义一个异步路由处理器

在 Starlette 中,定义异步路由处理器非常简单,只需在 `Route` 或 `APIRouter` 中指向一个标记为 `async` 的函数即可。框架会自动检测该函数的可等待性(awaitable),并在事件循环中运行它。以下是一个完整的示例程序,展示了如何创建一个包含异步 GET 和 POST 端点的 Starlette 应用,并使用 `uvicorn` 启动。

from starlette.applications import Starlette
from starlette.routing import Route, Mount
from starlette.responses import JSONResponse
import asyncio

async def homepage(request):
    # 模拟异步 I/O 操作
    await asyncio.sleep(0.1)
    return JSONResponse({"status": "ok", "message": "Hello Async"})

async def process_data(request):
    body = await request.json()
    # 模拟数据处理
    await asyncio.sleep(0.05)
    return JSONResponse({"received": body, "processed": True})

routes = [
    Route("/", endpoint=homepage),
    Route("/data", endpoint=process_data, methods=["POST"]),
]

app = Starlette(routes=routes)

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

运行上述代码后,访问 `http://localhost:8000/` 将返回 JSON 响应。预期结果为:GET 请求返回 `{"status": "ok", "message": "Hello Async"}`,POST 请求到 `/data` 并携带 JSON 体时,返回包含原始数据和 `processed: true` 的响应。所有 I/O 操作均未阻塞主线程。

如何配置Starlette以支持异步请求

如何处理中间件中的异步逻辑

Starlette 的中间件同样支持异步执行。若需在请求到达路由前或响应发送后执行异步任务(如日志记录、缓存检查),应使用 `ASGIApp` 类型的异步中间件。以下代码展示了一个简单的异步认证中间件,它在请求处理前检查 Header 中的 Token,若无效则提前返回 401 错误,否则继续调用下一个 App。

Starlette 1.5.1
Starlette 1.5.1

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

下载
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.requests import Request
from starlette.responses import JSONResponse
import asyncio

class AuthMiddleware(BaseHTTPMiddleware):
    async def dispatch(self, request: Request, call_next):
        token = request.headers.get("Authorization")
        if not token:
            return JSONResponse({"error": "Missing token"}, status_code=401)
        
        # 模拟异步令牌验证
        await asyncio.sleep(0.01)
        is_valid = token == "valid-token"
        
        if not is_valid:
            return JSONResponse({"error": "Invalid token"}, status_code=403)
            
        response = await call_next(request)
        return response

# 将中间件添加到应用中
app.add_middleware(AuthMiddleware)

此中间件通过继承 `BaseHTTPMiddleware` 并重写 `dispatch` 方法实现。注意 `dispatch` 必须是 `async` 函数,且必须 `await call_next(request)` 以获取后续处理结果。若跳过 `await`,可能导致竞态条件或资源泄漏。预期行为:无 Token 请求返回 401,Token 不为 `valid-token` 返回 403,其他请求正常通过并返回原响应。

如何配置Starlette以支持异步请求

当异步函数抛出异常时 Starlette 如何响应

在异步路由或中间件中,若未捕获的异常被抛出,Starlette 会将其转换为 HTTP 500 错误响应。例如,若在 `homepage` 函数中故意引发 `ValueError`,客户端将收到状态码 500 及默认错误页面。开发者可通过全局异常处理器自定义此类行为。以下代码演示了如何注册一个异常处理器,将特定异常映射为自定义 JSON 响应。

from starlette.exceptions import HTTPException
from starlette.requests import Request
from starlette.responses import JSONResponse

async def custom_exception_handler(request: Request, exc: Exception):
    if isinstance(exc, ValueError):
        return JSONResponse(
            {"error": "Bad data", "detail": str(exc)},
            status_code=400
        )
    # 其他异常保持默认 500 行为
    raise exc

app.add_exception_handler(ValueError, custom_exception_handler)

添加上述处理器后,再次触发 `ValueError` 将返回 400 状态码及详细错误信息,而非通用 500 错误。这有助于前端根据状态码区分业务逻辑错误与服务器内部错误。注意:仅 `ValueError` 会被拦截,其他异常仍由默认机制处理。预期结果:调用引发 `ValueError(

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

starlette

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

2025.12.22

119

5

Python 微服务架构与 FastAPI 框架
Python 微服务架构与 FastAPI 框架

本专题系统讲解 Python 微服务架构设计与 FastAPI 框架应用,涵盖 FastAPI 的快速开发、路由与依赖注入、数据模型验证、API 文档自动生成、OAuth2 与 JWT 身份验证、异步支持、部署与扩展等。通过实际案例,帮助学习者掌握 使用 FastAPI 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

2026.02.06

594

18

Python Web框架FastAPI 全栈开发教程合集
Python Web框架FastAPI 全栈开发教程合集

以 FastAPI 为核心,讲解现代 Python Web API 的高效开发方式,涵盖路由定义与路径参数/查询参数/请求体绑定、Pydantic 模型的数据校验与序列化、依赖注入(Depends)系统的分层设计、中间件与 CORS 配置、OAuth2 + JWT 认证流程、后台任务(BackgroundTasks)、WebSocket 实时通信、SQLAlchemy 异步 ORM 集成、自动生成 OpenAPI/Swagger 交互文

2026.05.09

796

23

Python FastAPI异步微服务与高性能接口设计
Python FastAPI异步微服务与高性能接口设计

本专题聚焦 Python FastAPI 框架在高性能接口与微服务开发中的应用,讲解异步请求处理、依赖注入机制、路由设计、数据库异步操作以及接口性能优化策略。结合实际项目案例,帮助开发者构建高并发、低延迟的现代化后端服务架构。

2026.06.16

679

12

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程