Python接口系统学习路线第534讲_核心原理与实战案例详解【指导】_技术教程

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() 函数，会被解析为一个“可调用节点”，其参数又会递归解析。

依赖函数里用 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 个足够，过多反而因上下文切换拖慢性能