在starlette中集成数据库连接池,推荐使用sqlalchemy的异步引擎配合`lifespan`事件管理生命周期。具体做法是在应用启动时创建引擎并初始化连接池,在应用关闭时执行清理操作,确保连接被正确释放。通过依赖注入或中间件将引擎传递给路由处理函数,即可在请求中复用连接。

如何配置异步引擎与连接池参数
配置的核心在于使用`create_async_engine`函数并设置合理的池大小参数。以SQLite为例,由于它是文件级锁,通常不需要大并发池,但为了演示通用性,可以设置`pool_size`和`max_overflow`。对于PostgreSQL或MySQL,需根据服务器最大连接数调整这些值。关键参数包括`pool_size`(基础连接数)、`max_overflow`(超出基础连接后的最大排队连接数)以及`pool_recycle`(连接回收时间,防止数据库断开空闲连接)。

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
import asyncio
from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
from sqlalchemy.orm import sessionmaker
from starlette.applications import Starlette
from starlette.routing import Route
from starlette.responses import JSONResponse
# 1. 配置异步引擎
DATABASE_URL = "sqlite+aiosqlite:///./test.db"
engine = create_async_engine(
DATABASE_URL,
pool_size=5,
max_overflow=10,
pool_recycle=3600,
echo=False
)
# 2. 创建会话工厂
async_session_factory = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
async def get_db():
async with async_session_factory() as session:
yield session
async def homepage(request):
# 实际使用中应通过依赖注入获取session
return JSONResponse({"status": "ok", "db_connected": True})
routes = [
Route("/", homepage),
]
app = Starlette(routes=routes)
如何在Lifespan事件中管理连接池生命周期
Starlette的`lifespan`上下文管理器是管理资源生命周期的标准方式。需要在`startup`阶段调用引擎的`connect`方法以预热连接池,或在首次请求前建立连接;在`shutdown`阶段必须调用`dispose`方法彻底销毁连接池,防止进程退出时残留连接导致错误。这一步骤确保了应用重启或停止时的数据一致性。

# 在Starlette应用中添加lifespan逻辑
async def lifespan(app):
# 启动时:创建连接池
async with engine.begin() as conn:
await conn.run_sync(lambda: None) # 触发连接创建
yield
# 关闭时:销毁连接池
await engine.dispose()
app = Starlette(routes=routes, lifespan=lifespan)
当连接池耗尽时会发生什么
当并发请求数超过`pool_size + max_overflow`时,新的请求会进入等待队列。如果所有连接都在使用中且达到溢出上限,后续请求将抛出`sqlalchemy.exc.TimeoutError`异常。这通常发生在高并发场景下未合理调优池参数时。开发者可以通过监控日志中的等待超时信息来调整`max_overflow`或增加`pool_size`,或者在代码中使用`await asyncio.wait_for(session.execute(...), timeout=5)`来捕获并处理此类超时,避免请求无限挂起。

















