FastAPI 依赖注入被你用成了全局变量？别慌，三分钟讲透

时间：2026-04-16 16:55

一、你可能正在这样写先来做个自我检测，看看你的代码有没有“中招”。打开你的 FastAPI 项目，如果发现了下面任何一种写法，那么恭喜——你可能已经成功地把依赖注入用成了全局变量。写法一：在依赖函数里塞了个列表，全项目共享状态 from fastapi import FastAPI, Depen

一、你可能正在这样写

先来做个自我检测，看看你的代码有没有“中招”。打开你的 FastAPI 项目，如果发现了下面任何一种写法，那么恭喜——你可能已经成功地把依赖注入用成了全局变量。

写法一：在依赖函数里塞了个列表，全项目共享状态

from fastapi import FastAPI, Depends

app = FastAPI()

# 这玩意儿叫“全局变量”，不叫“依赖注入”
cache = []

@app.get("/items")
async def get_items():
    cache.append("data")
    return {"cache": cache}

写法二：在路由函数里直接 import 一个单例，假装在用依赖注入

from fastapi import FastAPI, Depends

app = FastAPI()

class Database:
    def __init__(self):
        self.connection = "I'm a global db!"

db = Database()  # 这行代码，值得警惕

@app.get("/items")
async def get_items(database: Database = Depends(lambda: db)):
    return database.connection

写法三：在依赖函数里保存了上一次请求的状态

from fastapi import FastAPI, Depends

app = FastAPI()

def get_user():
    # 每次请求，上一个用户的数据还留着
    user_data = {"name": "last_user"}
    return user_data

@app.get("/profile")
async def profile(user = Depends(get_user)):
    return user

如果以上写法你都没用，那真要恭喜你：要么你是天赋异禀，要么就是项目还没真正开始。如果中了招——别慌，往下看，三分钟带你回到正轨。

二、依赖注入到底是什么

在讨论“什么错了”之前，得先搞清楚“什么是对的”。

FastAPI 的依赖注入，本质上是一个请求级别的工厂函数。每次请求到来，框架都会帮你调用一次这个“工厂”，把返回值注入到路由函数里。请求一结束，这个对象也就随之消失了。

打个比方，就像医院挂号：你去医院看病，医生让你去抽血。抽血窗口每次只服务一个病人，你抽完走了，下一个人来，护士会重新准备一套全新的工具。

依赖注入就是这个逻辑——每个请求拥有自己独立的对象，彼此互不干扰。

而全局变量则是另一回事：你抽完血走了，抽血窗口的工具还留在那儿，下一个人来了，发现里面可能还躺着上一个人的血样。

这就是 FastAPI 依赖注入的核心特征：请求隔离，自动清理。

三、正确的打开方式

场景一：数据库连接（最常见）

from fastapi import FastAPI, Depends
from sqlalchemy.orm import Session

# 每次请求进来，创建新的连接；请求结束，自动关闭
def get_db():
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()

@app.get("/users/{user_id}")
async def get_user(user_id: int, db: Session = Depends(get_db)):
    return db.query(User).filter(User.id == user_id).first()

关键点：这里的 yield 是精髓——yield 前面的代码在请求开始时执行，yield 后面的代码在请求结束时执行，资源清理自动完成，干净利落。

场景二：用户认证（链式依赖）

from fastapi import Depends, HTTPException

# 第一层：提取 Token
def get_token(token: str = Header(None)):
    if not token:
        raise HTTPException(status_code=401, detail="未登录")
    return token

# 第二层：验证 Token，返回用户信息
def get_current_user(token: str = Depends(get_token)):
    user = verify_jwt(token)
    if not user:
        raise HTTPException(status_code=401, detail="Token 无效")
    return user

# 在路由中使用，依赖链自动解析
@app.get("/profile")
async def profile(user = Depends(get_current_user)):
    return {"username": user.username}

关键点：get_current_user 依赖 get_token，FastAPI 会自动帮你处理调用顺序，路由函数里只需要写 Depends(get_current_user) 即可，逻辑清晰，职责分明。

场景三：应用级全局依赖（跨所有路由）

from fastapi import FastAPI, Depends, Header, HTTPException

async def verify_api_key(x_api_key: str = Header(...)):
    if x_api_key != "your-secret-key":
        raise HTTPException(status_code=403, detail="API Key 不对")
    return x_api_key

# 加在 app 上，所有路由都要过这关
app = FastAPI(dependencies=[Depends(verify_api_key)])

@app.get("/items")
async def read_items():
    return [{"item": "Portal Gun"}]

@app.get("/users")
async def read_users():
    return [{"username": "Rick"}]

关键点：app = FastAPI(dependencies=[...]) 是全局拦截器，所有路由都要过这一关。这非常适合添加像 API Key 校验这种“每个接口都必须有”的统一逻辑。

四、什么时候真的可以用“全局变量”

坦白说，有两种情况，使用全局变量是合理且安全的：

情况一：配置参数（不涉及请求状态）

from fastapi import FastAPI

app = FastAPI()

# 写死的配置常量，不是请求状态，完全 OK
MAX_PAGE_SIZE = 100
DEFAULT_TIMEOUT = 30

情况二：Lru_cache 缓存（读写分离，明确知道自己在干什么）

from functools import lru_cache

@lru_cache()
def get_config():
    # 应用启动时加载一次，整个进程生命周期内不变
    return load_config_from_file()

@lru_cache()
def get_redis_client():
    # 连接池，通常在应用启动时建立，不随请求创建/销毁
    return redis.Redis(host="localhost")

记住一个简单的原则：但凡涉及请求状态（用户数据、token、请求参数），就老老实实用 Depends。配置和只读的缓存，才是全局变量的主场。