fastapi-utils的CBV视图中如何为特定端点排除类级依赖？

可行的单端点排除类级依赖方案 #

fastapi-utils 自带的 cbv 实现没有内置类级依赖的单端点排除开关：装饰器运行时会直接把类属性中声明的所有Depends统一注入到类下所有注册路由的方法中，没有内置跳过逻辑。实际开发中可以用三种方案解决这个问题：

• 按依赖边界拆分cbv类：这是最稳妥、无兼容问题的方案。把需要公共鉴权依赖的接口和不需要的接口拆成两个独立的cbv类，仅在需要鉴权的类中声明session_user类级依赖，不需要鉴权的类不声明该属性即可，完全贴合库本身的设计逻辑。
• 改造依赖实现可选鉴权+端点标记：不直接将强制认证的get_session_user作为类级依赖，而是实现一个支持跳过的可选鉴权依赖，配合自定义装饰器给特定端点打标：

from fastapi import Request, Depends
from typing import Optional

# 改造后的可选鉴权依赖
async def get_optional_session_user(request: Request) -> Optional[User]:
    # 检测当前端点是否打了跳过认证的标记
    if getattr(request.endpoint, "_skip_auth_check", False):
        return None
    # 复用原有强制认证逻辑
    return await get_session_user(request)

# 给不需要鉴权的端点打标记的装饰器
def skip_auth(func):
    func._skip_auth_check = True
    return func

改造后类级依赖替换为可选版本：session_user: Optional[User] = Depends(get_optional_session_user)，在不需要鉴权的接口上加上@skip_auth装饰器即可，访问这类接口时不会触发强制认证，注意这类接口内部不要调用self.session_user的属性即可。

• 替换支持细粒度依赖控制的类视图实现：如果项目中这类排除需求很多，可以换用原生支持类视图依赖排除的FastAPI扩展库，减少自定义改造的成本。

官方文档未说明该限制的原因 #

这个行为本质是cbv模块的默认设计选择，不属于功能bug：fastapi-utils的cbv设计里，类属性声明的依赖定位是整个类所有端点的公共依赖，和FastAPI原生在APIRouter上传入dependencies参数的逻辑完全一致——路由级/类级的公共依赖默认作用于所有下属端点，本身就没有设计单端点排除的逻辑。作者大概率认为这个行为属于类视图的默认预期行为，因此没有单独做特殊说明。

如果不想拆分代码、也不想改造依赖，可以直接修改本地cbv装饰器的源码：在遍历类方法注入依赖的逻辑里加个端点标记判断，遇到打了排除标记的端点就跳过对应类依赖注入，整体改动量不超过10行，也可以给上游提交PR增加这个特性。

内容的提问来源于stack exchange，提问作者Michael Aboryone