FastAPI内部如何将请求、Header、Query等参数注入依赖函数？

一、依赖函数的执行时机与位置 #

当客户端请求到达FastAPI的路由端点（比如示例中的/items/或/users/）时，FastAPI会优先执行该端点绑定的依赖函数，完成后才会调用对应的端点处理函数（read_items或read_users）。

• 同一请求内如果多个端点或嵌套依赖复用了同一个依赖函数，默认会缓存执行结果，避免重复运行；不同请求则会重新执行依赖函数。
• 依赖函数的执行完全由FastAPI的请求处理流水线接管，属于请求解析到端点执行之间的核心步骤。

二、参数传递的具体过程 #

FastAPI的依赖注入系统和端点函数的参数解析逻辑是同一套机制，具体步骤如下：

1. 请求解析与参数匹配 #

当请求进入后，FastAPI会先解析请求的所有组成部分（查询参数、路径参数、请求头、请求体等）。对于依赖函数（比如示例中的common_parameters）的参数：

• 像q、skip、limit这类未指定来源的基础类型参数，FastAPI默认从查询参数中匹配同名字段；
• 如果参数标注了Header、Path、Body等类型，FastAPI会从对应的请求位置提取数据。

2. 类型校验与转换 #

FastAPI会自动对提取到的参数做类型校验和转换：

• 比如请求中skip的查询参数是字符串"10"，会被自动转换为整数10，匹配依赖函数中skip: int的类型定义；
• 如果参数不符合类型要求（比如skip传了非数字字符串），FastAPI会直接返回422类型错误响应。

3. 执行依赖函数并传递结果 #

将解析转换后的参数传入依赖函数并执行，得到返回值（示例中是包含q、skip、limit的字典），再将这个返回值赋值给端点函数中用Annotated[dict, Depends(...)]标注的参数（比如commons）。

4. 执行端点处理函数 #

拿到依赖传递的结果后，FastAPI才会执行端点处理函数，最终将结果返回给客户端。

示例场景演示 #

比如客户端发送请求：GET /items/?q=test&skip=10&limit=50

1. FastAPI解析查询参数q=test、skip=10、limit=50；
2. 将参数转换为对应类型后传入common_parameters，执行得到{"q": "test", "skip": 10, "limit": 50}；
3. 将这个字典赋值给read_items的commons参数；
4. 执行read_items，直接返回commons的内容作为响应。

内容的提问来源于stack exchange，提问作者Sudip Bhattarai