四川省和城乡建设厅网站哈尔滨网站建设网络优化

四川省和城乡建设厅网站,哈尔滨网站建设网络优化,建筑设计规范,全屋整装120平米的多少钱FastAPI实战#xff1a;你以为的启动与关闭#xff0c;远不止开始和结束 摘要#xff1a;本文详细探讨了FastAPI的Lifespan#xff08;生命周期#xff09;管理#xff0c;从为什么需要它、它的核心工作原理#xff0c;到使用/* by yours.tools - online tools website …FastAPI实战你以为的启动与关闭远不止开始和结束摘要本文详细探讨了FastAPI的Lifespan生命周期管理从为什么需要它、它的核心工作原理到使用/* by yours.tools - online tools website : yours.tools/zh/dnsedu.html */ asynccontextmanager的最佳实践、常见“坑点”及解决方案。通过一个完整的实战示例你将学会如何优雅地管理数据库连接池、配置加载等资源确保应用稳定可控。有没有在部署FastAPI应用后遇到过这些状况→ 服务一重启前几个请求总是失败日志里飘着“数据库连接错误”。→ 想优雅地关闭给下游服务发个通知却发现请求直接被掐断资源清理了个寂寞。→ 依赖项比如配置、外部客户端的初始化代码散落在路由和中间件里维护起来头大。这些都是用app.on_event(startup)和shutdown踩坑踩出来的经验和眼泪。今天咱们就来聊聊它的正统接班人——/* by yours.tools - online tools website : yours.tools/zh/dnsedu.html */ Lifespan以及怎么用它写出更健壮、更专业的FastAPI应用。 第一部分问题出在哪从“餐厅”的混乱开业说起想象一下你开了一家数字餐厅你的FastAPI应用。老做法on_event早上开业时间到了厨师数据库连接池、服务员配置、采购员HTTP客户端才慌慌张张地各自开始准备。客人请求已经进门点菜了厨师可能连锅都还没热。晚上打烊时一声令下直接拉闸采购员手里还在进行的订单、厨师没洗的锅全都戛然而止。这就是早期启动/关闭事件的异步问题以及缺乏对“准备”和“清理”阶段的精细控制。FastAPI在较新的版本中引入了lifespan参数它是一个异步上下文管理器。它的核心思想是在应用正式处理请求前把所有“家当”都准备好在应用退出前有条不紊地收拾好所有“家当”。这确保了在应用生命周期内资源状态是确定的。 第二部分核心原理与步骤一个 yield 搞定所有lifespan的原理其实就是Python异步上下文管理器的经典模式__aenter__和__aexit__。在FastAPI里我们用一个asynccontextmanager装饰器就能优雅实现。它的工作流超级清晰1️⃣yield之前启动逻辑。在这里连接数据库、加载配置、创建各种客户端。2️⃣yield那一刻应用进入“运行就绪”状态。此时所有资源都已初始化完毕可以安全接收请求。3️⃣yield之后关闭逻辑。在这里关闭连接池、清理临时文件、发送关闭通知。重点所有在yield前初始化的对象都可以通过request.app.state在整个应用范围内共享。这是依赖注入的“后勤总部” 第三部分实战演示手把手搭一个稳如老狗的应用光说不练假把式来看一个集成了Redis连接池和配置管理的实战例子。你完全可以直接复制改改就能用。from contextlib import asynccontextmanager from fastapi import FastAPI, Depends, Request import redis.asyncio as redis # 假装从环境或文件加载的配置 APP_CONFIG {redis_url: redis://localhost, max_connections: 10} # 这里是核心定义 lifespan asynccontextmanager async def app_lifespan(app: FastAPI): 应用生命周期管理 1. 启动创建Redis连接池 2. 运行保持 3. 关闭清理连接池 print( 应用启动中...正在初始化资源) # --- 启动阶段 --- # 初始化Redis连接池 try: redis_pool redis.ConnectionPool.from_url( APP_CONFIG[redis_url], max_connectionsAPP_CONFIG[max_connections], decode_responsesTrue ) app.state.redis_pool redis_pool app.state.config APP_CONFIG # 配置也存进去 print(✅ Redis连接池和配置初始化完成) except Exception as e: print(f❌ 资源初始化失败: {e}) # 这里一定要失败不要让应用带着问题启动 raise # yield 标志着应用正式启动完成开始接收请求 yield # --- 关闭阶段 --- print(\n 应用关闭中...正在清理资源) # 关闭Redis连接池 if hasattr(app.state, redis_pool): await app.state.redis_pool.disconnect() print(✅ Redis连接池已关闭。) print( 资源清理完毕应用安全退出。) # 创建App注入lifespan app FastAPI(titleLifespan Demo, lifespanapp_lifespan) # 一个依赖项用于在路由中方便地获取Redis连接 async def get_redis(request: Request): # 直接从app.state获取连接池并创建临时连接 async with redis.Redis(connection_poolrequest.app.state.redis_pool) as client: yield client # 示例路由 app.get(/cache/{key}) async def get_cache(key: str, redis Depends(get_redis)): value await redis.get(key) return {key: key, value: value} app.post(/cache/{key}) async def set_cache(key: str, value: str, redis Depends(get_redis)): await redis.set(key, value, ex60) # 60秒过期 return {msg: OK} app.get(/config) async def show_config(request: Request): # 直接访问全局配置 return request.app.state.config if __name__ __main__: import uvicorn uvicorn.run(app, host0.0.0.0, port8000)跑起来之后你会看到控制台先打印启动日志Uvicorn工人就位后应用才开始监听请求。用CtrlC关闭时关闭逻辑也会被执行。 第四部分常见坑点 我的血泪经验好了代码跑通了但下面这些才是保证你不上生产环境“演砸”的关键。 坑点一启动失败处理不当-问题如果在yield之前初始化数据库失败了你该怎么办-我的教训千万别吞异常就像上面代码里做的必须raise出去让应用启动失败。一个连不上数据库的应用不如不启动。可以通过日志和监控系统及时告警。 坑点二在lifespan里写“慢”逻辑-问题Lifespan的启动阶段会阻塞应用启动。如果你在这里跑一个耗时10分钟的数据同步任务你的服务就10分钟不可用。-我的建议对于非核心、耗时的初始化如预加载大数据模型考虑在yield后用后台任务异步执行。或者设计成懒加载模式在第一次请求时初始化。 坑点三忽略异步上下文管理-问题像数据库连接池、HTTP客户端这类资源它们自己往往也需要async with来管理生命周期。-正确做法仔细阅读你用的客户端库文档。像上面redis的ConnectionPool.disconnect()它就是异步的必须await。同步客户端则通常在.close()。 坑点四State滥用-问题app.state不是万能的储物间它适合放全局、只读或线程/协程安全的对象。-警告别往里塞请求级别的数据也别放频繁修改的全局变量这会在多worker环境下让你怀疑人生。共享配置、连接池、初始化好的客户端实例是它的最佳拍档。 最后啰嗦一句使用lifespan本质上是一种“契约编程”。你向框架承诺“我会管好我带来的资源”框架向你保证“我会在正确的时间点给你执行管理的权利”。它让我们的应用从“能跑”进化到“跑得稳、关得优雅”。尤其是在云原生和容器化环境下优雅启停是保证服务高可用的基础一环。希望这篇融合了我不少“坑”的文章能帮你把FastAPI用得更加得心应手。如果你有更妙的用法或者也踩过有趣的坑欢迎来聊聊觉得有用就赶紧收藏吧这种实战细节下次配置新项目时翻出来看一眼能省下不少查文档和Debug的时间。我是一名程序媛我们下次见