Python接口系统核心是理解HTTP协议及资源生命周期:requests.Session复用连接、Flask钩子非中间件、FastAPI依赖注入需异步适配、uvicorn--reload禁用于生产。

Python 接口系统不是靠堆砌框架学出来的,核心在于理解 HTTP 协议如何被 Python 程序解析、构造和调度——requests 只是封装,Flask 和 FastAPI 本质都是对 wsgi 或 asgi 协议的实现。
为什么用 requests.Session() 而不是反复调用 requests.get()
频繁新建 requests.get() 会重复建立 TCP 连接,触发三次握手和 TLS 握手,尤其在高并发或 HTTPS 场景下延迟明显。而 Session 自动复用连接、管理 Cookie、支持默认 headers 和 auth。
- 每次
requests.get()都是全新连接,无连接池,无法复用 -
Session默认启用urllib3.PoolManager,连接可复用、可配置最大数(pool_connections/pool_maxsize) - Cookie 自动持久化:登录后调用
session.post(login_url),后续session.get(profile_url)自带凭证 - 避免手动传
headers={'User-Agent': ...},直接设session.headers.update(...)
Flask 的 before_request 和 after_request 不等于中间件
它们是 Flask 特有的钩子函数,只在请求进入视图前/响应返回前执行,不拦截异常、不处理流式响应、不覆盖 Response 对象本身——真要改响应体或加 CORS 头,得用 app.after_request;但若需鉴权失败直接中断流程,必须用 @app.before_request + abort(401) 或 return 响应对象。
-
before_request中抛出异常不会被自动捕获,需配合@app.errorhandler -
after_request接收的是Response实例,不能修改 status code 以外的内容(比如 body 已压缩或流式发送) - 真正等价于中间件的是 WSGI 层包装,例如:
def my_middleware(app): def middleware(environ, start_response): # do something before response = app(environ, start_response) # do something after return response return middleware
FastAPI 的 Depends() 不是装饰器嵌套,而是依赖注入调度器
Depends() 触发的是 FastAPI 内置的依赖解析器,它按拓扑顺序构建依赖图,缓存单例、处理异步依赖、支持嵌套依赖——你写的 def get_db() 函数,会被解析为一个“可调用节点”,其参数又会递归解析。
立即学习“Python免费学习笔记(深入)”;
- 依赖函数里用
yield时,FastAPI 会自动拆成 setup / teardown 两阶段(类似 contextlib.contextmanager) - 同名依赖多次出现在不同路径参数中,只会执行一次(除非显式设
use_cache=False) - 不要在
Depends()里写耗时同步操作(如文件读取),否则阻塞整个 event loop;该用async def+run_in_executor - 错误提示
TypeError: 'Depends' object is not callable通常是你误写了Depends(get_user())(多了一对括号)
uvicorn 启动时加 --reload 在生产环境会出事
--reload 依赖 watchfiles 监听文件变更并热重启 worker,但它会杀死旧进程、启动新进程,期间存在请求丢失窗口;更严重的是,它会扫描整个项目目录(包括 __pycache__、.git),导致 CPU 暴涨、inode 占满,某些容器环境直接 OOM。
- 开发用:
uvicorn main:app --reload --reload-dir ./src --reload-exclude "*/tests/*" - 生产禁用
--reload,改用进程管理器(systemd/supervisord)或容器健康检查 + 优雅重启 - 若需热更新配置,应把配置抽离为外部文件(如
pydantic.BaseSettings),运行时重载而非重启进程 -
--workers数量别盲目设成cpu_count * 2 + 1,异步应用(FastAPI + async DB)通常 1–4 个足够,过多反而因上下文切换拖慢性能
接口系统的复杂性不在语法,而在协议边界、生命周期控制和资源释放时机——比如一个 Session 忘关、一个数据库连接没进 finally、一个 Depends 里的异步生成器没加 await,问题往往在线上压测时才暴露。










