FastAPI中async依赖报“Sync dependency in async route”错，因未显式声明异步依赖或路由函数非async def；须确保依赖与路由均为async def、使用异步DB驱动、Token解析同步而查库等IO操作异步。
FastAPI里用async def写权限校验依赖，为什么报错“Sync dependency in async route”
因为FastAPI默认把所有依赖当作同步函数处理，即使你写了async def，如果没显式声明为异步依赖，它会在事件循环外调用，直接抛RuntimeError: There is no current event loop in thread或静默降级成同步执行——导致await失效、数据库连接阻塞主线程。
实操要点：
- 必须在依赖函数定义时加
dependency=Depends(your_async_func)，且your_async_func本身是async def - 路由函数也必须是
async def，否则FastAPI不启用异步上下文 - 别在依赖里混用
time.sleep()或同步DB驱动（如普通psycopg2），要用asyncpg、aiomysql或SQLModel`+`AsyncSession - FastAPI 0.95+ 支持原生异步依赖，低版本需确认是否打了
fastapi[all]补丁
如何在async依赖里安全读取Bearer Token并查数据库验权
Token解析本身是同步的（jwt.decode），但查用户、查角色、查权限树这些IO操作必须异步。常见错误是把jwt.decode包进await asyncio.to_thread()——纯属多余，反而增加调度开销。
正确做法：
立即学习“Python免费学习笔记（深入）”；
- 用
Authorizationheader提取token字符串（同步） - 用
jwt.decode(..., options={"verify_signature": False})先解出user_id或sub（同步，不验签避免阻塞） - 再用
await db.execute(select(User).where(User.id == user_id))查库（异步） - 权限判断逻辑（比如检查
user.role == "admin"或查Permission关联表）全在await之后写
示例片段：
async def verify_admin(db: AsyncSession = Depends(get_db), token: str = Depends(oauth2_scheme)):
try:
payload = jwt.decode(token, SECRET_KEY, algorithms=["HS256"])
user_id = payload.get("sub")
if not user_id:
raise HTTPException(401, "Invalid token")
result = await db.execute(select(User).where(User.id == user_id))
user = result.scalar_one_or_none()
if not user or user.role != "admin":
raise HTTPException(403, "Insufficient permissions")
return user
except JWTError:
raise HTTPException(401, "Invalid token")
为什么用了async依赖，接口响应反而变慢甚至超时
根本原因不是异步本身慢，而是错误复用了非异步资源：比如全局单例的同步Redis客户端、共享的threading.Lock、或者没配置连接池上限的asyncpg.Pool。
排查方向：
- 检查DB Pool size是否过小：
pool_size=10对中等QPS就可能打满，建议设为min_size=5, max_size=20 - Redis是否用了
aioredis.from_url(...)而非redis.Redis()（后者会阻塞event loop） - 有没有在依赖里调用
os.getenv()以外的同步IO（比如读本地config.json文件），应改用await aiofiles.open().read() - 日志是否用了同步handler（如
FileHandler），换成aiologger或异步写入队列
多个async依赖嵌套时，如何避免重复解析Token或查库
FastAPI默认对同一请求内相同依赖只运行一次，但前提是依赖函数签名完全一致——包括参数名、默认值、类型注解。一旦你给verify_admin和verify_user都传了token: str = Depends(oauth2_scheme)，它们各自会独立执行token解析和DB查询。
优化方式：
- 把token解析和基础用户加载拆成一个底层async依赖（如
get_current_user），其他权限依赖都基于它构建 - 用
request.state.user = user缓存到Request对象（注意：仅限单次请求生命周期，线程安全） - 避免在依赖里做
await get_current_user()调用，改用Depends(get_current_user)让FastAPI统一管理生命周期
真正容易被忽略的是：request.state在中间件里赋值后，依赖函数里能读到；但如果依赖函数自己raise了HTTPException，request.state里的对象不会自动清理，下次同请求重试可能误用旧状态——得靠严谨的try/finally或contextvars隔离。
