FastAPI认证后端启动报错：如何正确启动Uvicorn服务器？

问题原因 #

你执行uvicorn main:app --reload时出错，核心原因是main.py模块中没有直接定义名为app的变量——你的FastAPI实例app实际定义在app/app.py文件里，main.py仅作为启动脚本，在if __name__ == "__main__"代码块中调用uvicorn加载真正的应用实例。

两种可行的启动方式 #

方式1：直接运行main.py脚本 #

在<project_name>/目录下执行以下命令：

python main.py

该命令会触发main.py中已写好的启动逻辑，自动加载app.app:app（即app/app.py里的FastAPI实例），完全匹配你当前的代码结构。

方式2：直接用uvicorn指向真实的应用模块 #

跳过main.py，直接让uvicorn加载app/app.py中的FastAPI实例，在<project_name>/目录下执行：

uvicorn app.app:app --reload

这里的app.app:app含义拆解：

• 第一个app：项目根目录下的app文件夹（Python包）
• 第二个app：app文件夹内的app.py模块
• 最后一个app：app.py中定义的FastAPI实例

额外提示 #

如果需要热重载（代码修改后自动重启服务器）：

• 方式2直接保留--reload参数即可；
• 方式1可修改main.py中的启动代码，添加reload=True参数：

import uvicorn

if __name__ == "__main__":
    uvicorn.run("app.app:app", host="0.0.0.0", log_level="info", reload=True)

内容的提问来源于stack exchange，提问作者Олег Якунин