starlette 的依赖注入系统通过 depends 类实现,核心做法是将需要复用的逻辑(如数据库会话、用户认证)封装为可调用对象或函数,并在路由定义中作为参数传入。当请求到达时,starlette 会自动实例化这些依赖并注入到视图函数中,从而解耦业务逻辑与基础设施代码。

Depends 如何解析嵌套依赖?
在 Starlette 中,Depends 支持递归解析。如果某个依赖函数的参数本身也是 Depends 类型,框架会先处理内层依赖,再将其结果传递给外层依赖。这种机制允许构建复杂的依赖树,例如从请求中提取 Token,验证后获取用户信息,最后查询数据库。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
from starlette.datastructures import Secret
import os
class Database:
def __init__(self):
self.connected = False
async def connect(self):
self.connected = True
print("DB Connected")
async def disconnect(self):
self.connected = False
print("DB Disconnected")
async def get_db():
db = Database()
await db.connect()
try:
yield db
finally:
await db.disconnect()
async def get_settings(request):
return {"secret": os.getenv("SECRET_KEY", "default")}
async def read_root(db: Database = Depends(get_db), settings: dict = Depends(get_settings)):
# db is injected via get_db
# settings is injected via get_settings
return JSONResponse({"status": "ok", "db_connected": db.connected, "settings": settings})
app = Starlette(routes=[Route("/", read_root)])
如何处理依赖中的异常和清理逻辑?
当依赖项抛出异常时,Starlette 会中断当前请求的处理链,并将异常直接返回给客户端(通常转为 HTTP 错误)。对于涉及资源管理的依赖(如数据库连接),推荐使用生成器函数配合 yield。在 yield 之前的代码用于设置(Setup),之后的代码用于清理(Teardown),无论请求成功与否,清理逻辑都会执行。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

async def get_db_with_error_handling():
db = Database()
try:
await db.connect()
if not db.connected:
raise RuntimeError("Failed to connect")
yield db
except Exception as e:
# Handle or log error
print(f"Error in dependency: {e}")
raise
finally:
await db.disconnect()
基于 get_db 输入条件的具体行为是什么?
针对上述代码中的 get_db 依赖,其输入条件是每次 HTTP 请求到达。具体行为是:框架首先调用 get_db,创建一个新的 Database 实例并调用 connect。随后将实例注入到 read_root。请求处理完毕后,立即执行 finally 块中的 disconnect。这意味着每个请求都拥有独立的数据库连接生命周期,避免了连接共享带来的状态污染问题。










