FastAPI lifespan使用疑问：全局变量实现是否合理？

你的lifespan用法是完全正确的——它确实在应用启动时初始化Webserver实例，在应用关闭时调用shutdown()清理资源，日志的验证结果也证明了这一点，这完全符合FastAPI生命周期管理的设计初衷。

针对你担心的全局变量代码异味问题，这里有两个更优的替代方案：

方案1：使用FastAPI依赖注入（推荐） #

依赖注入是FastAPI的核心特性之一，用它提供Webserver实例可以彻底消除全局变量，同时让代码更易测试和维护。

修改步骤：

1. 保留lifespan逻辑，但将Webserver实例存入app.state（官方预留的自定义状态存储区）：

from contextlib import asynccontextmanager
from fastapi import FastAPI

@asynccontextmanager
async def lifespan(app: FastAPI):
    # 初始化Webserver并存入app.state
    app.state.webserver = Webserver()
    yield
    # 关闭资源
    app.state.webserver.shutdown()

app = FastAPI(lifespan=lifespan)

2. 创建一个依赖函数用于获取Webserver实例：

from fastapi import Depends, Request

def get_webserver(request: Request):
    return request.app.state.webserver

3. 在路由函数中通过Depends注入实例：

@app.post('/api/send_order')
def send_order(
    fastapi_order_insert_message: FastAPI_OrderInsertMessage,
    request: Request,
    response: Response,
    webserver = Depends(get_webserver)  # 注入Webserver实例
):
    debug_print_pid()
    timestamp = now()
    ip = request.client.host
    log.info(f'POST /api/send_order ({ip}, {timestamp})')

    try:
        return webserver.send_order(fastapi_order_insert_message)
    except Exception as error:
        response.status_code = status.HTTP_500_INTERNAL_SERVER_ERROR
        return FastAPI_ReturnStatus(
            status='error',
            message='internal server error',
        )

这个方案的优势：

• 彻底消除全局变量，代码逻辑更清晰
• 便于单元测试：可以轻松替换为Mock版Webserver实例
• 符合FastAPI设计规范，扩展性更强

方案2：直接使用app.state获取实例（简单直接） #

如果觉得依赖注入过于繁琐，app.state是官方专门为用户自定义数据设计的存储区，比直接给app加属性安全得多（不会和FastAPI内置属性冲突），可以直接在路由中获取：

@app.post('/api/send_order')
def send_order(
    fastapi_order_insert_message: FastAPI_OrderInsertMessage,
    request: Request,
    response: Response,
):
    debug_print_pid()
    timestamp = now()
    ip = request.client.host
    log.info(f'POST /api/send_order ({ip}, {timestamp})')

    # 直接从app.state获取Webserver实例
    webserver = request.app.state.webserver
    try:
        return webserver.send_order(fastapi_order_insert_message)
    except Exception as error:
        response.status_code = status.HTTP_500_INTERNAL_SERVER_ERROR
        return FastAPI_ReturnStatus(
            status='error',
            message='internal server error',
        )

这个方案适合小型项目或追求代码简洁性的场景，无需额外编写依赖函数。

关于直接给app添加自定义属性的问题 #

不建议直接给app对象加自定义属性（比如app.webserver = Webserver()），因为FastAPI的FastAPI类本身有大量内置属性，存在命名冲突的潜在风险。而app.state是官方预留的安全存储区，完全可以放心使用。

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