fastapi项目细节和启动顺序

最新推荐文章于 2025-10-18 06:05:27 发布

原创

最新推荐文章于 2025-10-18 06:05:27 发布 · 994 阅读

22 ·

CC 4.0 BY-SA版权

文章标签：

#fastapi

要搞清楚 FastAPI 项目启动的执行逻辑，需要先明确 “项目启动流程”“main 函数角色”“lifespan 作用”“导入语句执行时机” 这几个核心点的关系，下面逐一拆解：

一、FastAPI 项目启动：先执行 “导入语句”，再执行 “main 函数”，最后触发 “lifespan”

FastAPI 项目的启动并非单一入口执行，而是遵循 “Python 解释器执行顺序”+“FastAPI 框架初始化逻辑” 的组合流程，整体顺序如下：

1. 第一步：执行所有 “导入语句”（最早发生）

当你通过命令（如 uvicorn main:app --reload）启动项目时，Python 解释器会先加载所有被引用的模块 ——导入语句（import）的执行时机，是 “模块被加载时”，早于任何函数（包括 main）的调用。

FastAPI 项目的启动并非单一入口执行，而是遵循 “Python 解释器执行顺序”+“FastAPI 框架初始化逻辑” 的组合流程，整体顺序如下：

1. 第一步：执行所有 “导入语句”（最早发生）

举个典型的项目结构例子：

your_project/
├── main.py       # 入口文件，有 app = FastAPI()、main 函数
└── config.py     # 配置文件，有 AGENT_CONFIGS、预加载文件逻辑

如果 main.py 中有这样的代码：

# main.py
# 1. 导入语句：此时会立即执行 config.py 中的所有代码
import config  
from fastapi import FastAPI

# 2. 初始化 FastAPI 实例：此时执行（早于 main 函数）
app = FastAPI()

# 3. 定义 main 函数（启动命令中可能不直接调用，除非主动执行）
def main():
    print("执行 main 函数")

# 4. 定义 lifespan（FastAPI 1.0+ 推荐的生命周期钩子）
@app.lifespan("startup")
async def startup_event():
    print("执行 startup 生命周期事件")

当你运行 uvicorn main:app 时，第一步就是执行导入语句 import config—— 这会触发 config.py 中的所有代码（包括初始化函数、类、变量如 AGENT_CONFIGS” 等逻辑），且这个过程在 app 实例化、main&nbs