fastapi 0.163及以上可在获取数据库会话的depends上设置max_concurrency,并让多个路由复用同一个annotated别名。这样,请求会在进入会话依赖前等待额度,yield后的关闭操作完成才释放额度。下面用sqlalchemy同步session演示同一进程内两个路由共享上限2;它不是跨worker的全局连接限制。
在独立环境安装并固定依赖
FastAPI 0.163.1要求Python 3.11及以上。示例使用同步SQLAlchemy接口,因此路由也用普通def;不要把同步数据库操作原样放进async def并认为它已经异步。
python3 -m venv .venv source .venv/bin/activate python -m pip install "fastapi==0.163.1" "uvicorn[standard]" "sqlalchemy>=2, requirements.lock.txt

官方共享额度示例,图中上限为5
把额度放在真正创建会话的位置
from typing import Annotated
from fastapi import Depends, FastAPI
from sqlalchemy import create_engine, text
from sqlalchemy.orm import Session
from sqlalchemy.pool import QueuePool
engine = create_engine(
"sqlite:///./demo.db",
connect_args={"check_same_thread": False},
poolclass=QueuePool, pool_size=5, max_overflow=0,
)
app = FastAPI()
def get_session():
with Session(engine) as session:
yield session
SessionDep = Annotated[Session, Depends(get_session, max_concurrency=2)]
@app.get("/first")
def first(session: SessionDep):
return {"value": session.execute(text("select 1")).scalar_one()}
@app.get("/second")
def second(session: SessionDep):
return {"value": session.execute(text("select 2")).scalar_one()}
保存为main.py,运行uvicorn main:app --workers 1,再分别请求/first和/second,两者应返回各自value。这个轻量示例验证接入路径,不会凭两次串行请求证明并发排队已经发生;验证排队需在测试环境中增加可控的占用时间并同时发出超过两次请求。

官方文档中的yield退出与额度释放说明
不要在每个路由重新创建Depends
上面两条路由共用SessionDep,因此共享额度。若每条路由各写一次Depends,即使函数都是get_session,也会创建不同的限制对象。当前默认request作用域会在响应发送后运行yield退出部分;确需在发送响应前关闭资源时,另按scope="function"的适用条件配置。
额度按进程及事件循环分别计算,两个worker各配置2,服务整体可能同时存在4个此类会话。应结合连接池、其他连接使用者与部署进程数留出容量;FastAPI不会自动识别数据库池大小。常规缓存复用不会再次占用额度;应避免持有额度后再发起需要新会话的未缓存调用,以及多个资源以相反顺序获取导致相互等待。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











