1. 什么是FastAPI中间件
中间件是Web开发中一个非常重要的概念,它就像是你家门前的一道安检门,所有进出的人(请求和响应)都要经过它的检查和处理。在FastAPI中,中间件是一个能够在请求到达路由处理器之前和/或响应返回客户端之前执行操作的组件。
想象一下这样的流程:当一个HTTP请求到达你的FastAPI应用时,它会先经过一系列中间件,就像通过一道道安检门。每个中间件都可以对请求进行检查、修改或者添加额外信息。处理完请求后,响应在返回给客户端之前,又会反向经过这些中间件,让它们有机会对响应进行处理。
下面是一个最简单的FastAPI中间件示例:
python复制from fastapi import FastAPI, Request
from fastapi.responses import JSONResponse
import uvicorn
app = FastAPI()
@app.middleware("http")
async def simple_middleware(request: Request, call_next):
# 请求处理前的操作
print(f"收到请求: {request.method} {request.url}")
# 调用下一个中间件或路由处理器
response = await call_next(request)
# 响应返回前的操作
if isinstance(response, JSONResponse):
response.headers["X-Processed-By"] = "SimpleMiddleware"
print(f"处理完成: {response.status_code}")
return response
@app.get("/")
async def root():
return {"message": "Hello World"}
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
这个简单的中间件做了三件事:在请求到达时打印日志,调用下一个处理环节,在响应返回前添加自定义头部。这就是中间件的基本工作模式。
中间件在FastAPI中有很多实际应用场景,比如记录请求日志、认证和授权、修改响应内容、性能监控、跨域资源共享(CORS)处理等。它们就像是应用的门卫、记录员和质检员,各司其职但又协同工作。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 常用内置中间件实战
2.1 CORSMiddleware:跨域资源共享处理
在现代Web开发中,前端和后端经常部署在不同的域名下,这就涉及跨域问题。CORSMiddleware就是FastAPI提供的解决跨域问题的利器。
跨域问题的本质是浏览器的同源策略限制。简单来说,浏览器不允许一个域下的网页脚本直接访问另一个域的资源。这是出于安全考虑,但给开发带来了不便。
CORSMiddleware的使用非常简单:
python复制from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
app = FastAPI()
# 配置CORS中间件
app.add_middleware(
CORSMiddleware,
allow_origins=["http://localhost:3000"], # 允许的前端地址
allow_credentials=True,
allow_methods=["*"], # 允许所有HTTP方法
allow_headers=["*"], # 允许所有头部
)
@app.get("/")
async def main():
return {"message": "Hello World"}
这个配置允许来自http://localhost:3000的跨域请求,支持所有HTTP方法和头部。在实际项目中,你应该根据需求精确配置允许的源、方法和头部,而不是简单地使用通配符"*",这能更好地保障应用安全。
2.2 GZipMiddleware:响应压缩优化
网络传
