FastAPI新版lifespan不生效，仅旧版事件监听方式可用

可能原因及对应解法 #

1. FastAPI版本不足 #

lifespan是FastAPI 0.95.0及以上版本才支持的特性，若你的FastAPI版本低于该阈值，新版lifespan会被直接忽略，不会执行。

检查当前版本：

pip show fastapi

升级到最新版：

pip install --upgrade fastapi uvicorn

2. 启动命令未正确指定应用实例 #

确保用uvicorn启动时，准确指向包含lifespan的app实例。比如代码文件为main.py，app实例变量名是app，启动命令应为：

uvicorn main:app --reload

若启动路径或实例名错误，会导致lifespan无法被加载执行。

3. 新旧事件处理方式冲突 #

如果代码中同时存在新版lifespan和旧版@app.on_event("startup")/@app.on_event("shutdown")，FastAPI会优先使用旧版事件监听逻辑，忽略新版lifespan。需移除所有旧版事件装饰器代码，仅保留新版lifespan实现。

4. 打印输出被日志覆盖 #

若启动日志输出较多，print("startup")的内容可能被其他日志淹没。建议改用logging模块输出，确保能在日志中明确看到：

import logging
from contextlib import asynccontextmanager
from fastapi import FastAPI

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

@asynccontextmanager
async def lifespan(app: FastAPI):
    logger.info("startup")
    await news_db_client.connect()
    yield
    await news_db_client.disconnect()

app = FastAPI(lifespan=lifespan)

验证步骤 #

1. 升级FastAPI和uvicorn到最新稳定版
2. 移除所有旧版@app.on_event装饰器代码
3. 用正确的uvicorn命令启动应用
4. 查看启动日志，确认startup日志是否正常输出

内容的提问来源于stack exchange，提问作者m4gic1337