starlette 集成 tortoise orm 的核心做法是在应用生命周期中初始化数据库连接并在关闭时清理资源,具体通过 starlette 的 lifespan 事件处理函数来实现。你需要在启动阶段调用 tortoise.init() 并注册模型,同时在关闭阶段调用 tortoise.close() 以确保连接池正确释放。这样可以在请求处理前建立好数据库会话,保证后续业务逻辑能直接访问 orm 实例。

如何在 Starlette 应用中配置 Lifespan 以管理数据库连接
通过在 Starlette 构造函数中传入 lifespan 参数,可以定义一个异步上下文管理器来处理启动和关闭逻辑。在启动时,使用 tortoise.Tortoise.init() 加载配置并生成连接池;在关闭时,调用 tortoise.Tortoise.close() 断开所有连接。这种模式确保了数据库资源的生命周期与 Web 应用同步,避免了连接泄漏或重复创建的问题。

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
import asyncio
from starlette.applications import Starlette
from starlette.routing import Route
from tortoise import Tortoise, fields
from tortoise.models import Model
class User(Model):
id = fields.IntField(pk=True)
name = fields.CharField(max_length=50)
async def init_db():
await Tortoise.init(
db_url='sqlite://:memory:',
modules={'models': ['__main__']}
)
await Tortoise.generate_schemas()
async def close_db():
await Tortoise.close_connections()
async def lifespan(app_state):
yield
# 注意:实际使用中通常将 init 放在 startup 事件中
async def startup():
await Tortoise.init(
db_url='sqlite://:memory:',
modules={'models': ['__main__']}
)
await Tortoise.generate_schemas()
async def shutdown():
await Tortoise.close_connections()
app = Starlette(
routes=[...],
on_startup=[startup],
on_shutdown=[shutdown]
)
如何在路由处理器中执行具体的数据库查询操作
在定义了数据库初始化和清理逻辑后,可以在具体的路由函数中直接使用 Tortoise ORM 提供的异步查询方法。例如,通过 User.create() 插入数据或使用 User.filter() 进行条件检索。由于这些操作都是异步的,需要在 Starlette 的路由处理函数中使用 await 关键字等待结果返回,从而确保数据库操作不会阻塞事件循环。

from starlette.responses import JSONResponse
from starlette.requests import Request
async def get_users(request: Request):
users = await User.all()
return JSONResponse([{"id": u.id, "name": u.name} for u in users])
async def create_user(request: Request):
data = await request.json()
user = await User.create(name=data["name"])
return JSONResponse({"id": user.id, "name": user.name}, status_code=201)
当数据库连接意外中断时程序会如何处理异常
如果数据库连接在运行期间因网络波动或服务重启而中断,Tortoise ORM 通常会抛出 ConnectionError 或相关的数据库驱动异常。此时,应用程序需要捕获这些异常并进行适当处理,例如记录日志或向客户端返回错误状态码。Starlette 的全局异常处理器可以拦截这些未处理的异常,防止整个服务崩溃,同时保持其他非数据库相关的路由正常工作。

















