可测试性关键在于依赖能被显式替换且不破坏类型签名和执行路径；必须用函数封装实例化逻辑，避免模块级硬编码；类型提示应指向协议或抽象接口，禁用具体类名；杜绝全局变量缓存跨请求状态。
直接硬编码依赖（比如 db = Database()）会让单元测试彻底失效——你没法替换它、mock 它、验证调用，甚至一个测试失败会污染后续所有测试。可测试性的关键不在于用了 Depends 或 injector.get()，而在于依赖是否能被显式替换且不破坏类型签名和执行路径。
依赖函数必须是纯函数或 yield 生成器
把实例化逻辑放在函数体内，而不是模块顶层；否则测试时连 override 的机会都没有。
- ❌ 错误写法：
db = Database("sqlite:///test.db")在模块加载时就创建，测试无法干预 - ✅ 正确写法：用函数封装，每次请求新建或复用连接池
- 如果需要资源清理（如数据库连接），用
yield返回对象，再在 finally 块中关闭 - FastAPI 中依赖默认按请求作用域执行，避免手动管理生命周期冲突
类型提示必须指向协议或抽象接口
写死具体类名（如 SQLAlchemyDatabase）会让 mock 失败或 mypy 报错，因为 mock 对象不满足具体类的全部方法签名。
- ✅ 推荐定义
class DatabaseProtocol(Protocol)，只声明query()和close() - ✅ 或直接使用 SQLAlchemy 的
AsyncSession这类已有抽象类型 - ❌ 避免
def get_db() -> SQLAlchemyDatabase:—— 它绑定了实现细节 - 类型提示越窄、越抽象，测试时越容易用
Mock(spec=DatabaseProtocol)替换
避免模块级变量缓存跨请求状态
用全局变量存连接、token 或配置实例，会导致测试间状态污染——前一个测试改了值，后一个测试读到脏数据。
- ❌ 危险模式：
_cache = {}+ 手动 set/get，没清理钩子 - ✅ FastAPI 依赖默认每次请求新建，天然隔离；如需共享（如配置），确保它是不可变或线程安全的
- ✅ 若必须缓存（如解析后的 YAML 配置），用
lru_cache()，并在测试 teardown 中调用cache_clear() - pytest fixture 是更安全的选择：作用域可控、自动 cleanup、支持依赖链
最容易被忽略的一点是：依赖注入本身不保证可测试性，它只是个传输通道。真正决定你能不能写干净单元测试的，是你定义依赖函数的方式——是否可重入、是否无副作用、是否类型可替换。哪怕不用任何框架，一个带类型提示的普通函数参数，只要满足这三点，就已经是可测试的依赖注入了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
