FastAPI中两种Depends依赖注入实现方式的差异是什么？

作为FastAPI新手，你提到的两段代码核心都是用Depends实现共享逻辑，但在写法规范、类型表达和扩展性上有明显区别：

1. 类型注解的表达方式差异 #

第一段（官方推荐写法） #

使用Python标准库的Annotated类型注解，将参数类型和依赖注入规则结合在一起：

from typing import Annotated
from uuid import UUID
from fastapi import APIRouter, Depends

router = APIRouter()

async def test_injection(id: UUID) -> str:
    return str(id)

@router.get("/", response_model=str)
async def get_root(uuid: Annotated[UUID, Depends(test_injection)]) -> str:
    return uuid

• 这种写法是FastAPI官方明确推荐的，Annotated可以清晰传递“该参数类型为UUID，同时由test_injection依赖提供值”的双重信息。
• 符合现代Python类型提示的最佳实践，支持添加多个元数据（比如后续可以叠加验证规则、文档描述等）。

第二段（常见社区写法） #

将Depends作为参数的默认值传入，同时单独标注参数类型：

async def test_injection(id: UUID) -> str:
    return str(id)

@router.get("/", response_model=str)
async def get_root(uuid: UUID = Depends(test_injection)) -> str:
    return uuid

• 这是早期FastAPI版本中常见的写法，本质是利用Python默认参数的语法实现依赖注入，但容易让阅读者误以为这是一个可选参数（因为用了=），实际在FastAPI中如果依赖没有默认值，该参数依然是必填的。
• 类型注解和依赖规则分离，扩展性较差，无法在同一参数上叠加多个元数据。

2. 类型检查的准确性问题 #

注意：你的两段代码都存在类型标注不匹配的问题——test_injection返回的是str类型，但参数uuid标注为UUID。这会导致mypy等类型检查工具报错，虽然FastAPI运行时会自动处理类型转换，但不符合类型安全规范。正确的写法应该是：

• 第一段：uuid: Annotated[str, Depends(test_injection)]
• 第二段：uuid: str = Depends(test_injection)

3. 扩展性与可读性对比 #

• Annotated写法的扩展性更强：可以在同一个参数上同时添加依赖、验证规则（如Query/Path的参数校验）、文档描述等元数据，代码结构更紧凑清晰。
• 默认参数写法的可读性较弱：容易和普通可选参数混淆，当依赖逻辑复杂时，无法直观区分参数的来源和规则。

内容的提问来源于stack exchange，提问作者Benjamin Geoffrey