为何在函数内修改FastAPI应用实例（如添加路由）无法生效？

这个问题的核心其实和Uvicorn加载FastAPI应用的机制有关，咱们来一步步理清楚：

关键原因：Uvicorn的模块导入逻辑 #

当你用uvicorn.run("main:app")这种字符串路径指定要运行的应用时，Uvicorn会在内部重新导入一次main模块，而不是直接使用当前进程里已经创建好的app实例。

这时候就出现了一个关键点：新导入的main模块中，__name__的值是main，而不是__main__，所以if __name__ == "__main__"这个条件不会成立——你的main()函数根本不会被执行！那里面的app.include_router(router)自然也就没机会运行，最终Uvicorn加载的其实是模块全局作用域里创建的、没有添加任何路由的空app实例。

对比你的两种写法 #

• 第一种能正常工作的写法：
  app.include_router(router)是在模块的全局作用域执行的，不管模块是被直接运行（python main.py）还是被Uvicorn导入，这行代码都会执行，所以app实例始终带着你注册的路由。

• 第二种失效的写法：
  路由注册逻辑被放在了main()函数里，只有当你直接运行脚本时，main()才会触发；但Uvicorn导入模块时不会走这个分支，所以加载的app完全是初始化时的状态，没有任何路由，自然会返回404，OpenAPI文档也看不到路由。

关于app.state的问题也是同理 #

你在main()函数里修改的是当前进程中app实例的状态，但Uvicorn加载的是重新导入模块后生成的全新app实例，两者根本不是同一个对象，所以你在请求里访问req.app.state时会出现属性错误。

解决方案 #

如果一定要在函数内完成app的配置，可以换一种方式给Uvicorn传应用：

uvicorn.run(
    app,  # 直接传入已经配置好的app实例，而不是字符串路径
    host=s.host,
    port=int(s.port),
    reload=(config.mode == "local"),
)

这样Uvicorn就会直接使用你在main()函数里已经添加好路由、修改过状态的app实例，不会再重新导入模块。

或者，你也可以把路由注册、状态配置这类逻辑移到模块的全局作用域，确保Uvicorn导入模块时能自动执行这些配置。

备注：内容来源于stack exchange，提问作者Alexey