FastAPI启动卡在Waiting for application startup的问题排查

以下是几种常见的原因及解决方向：

• 启动事件阻塞：检查main.py中@app.on_event("startup")装饰的函数，若其中包含同步耗时操作（如无超时的网络请求、无限循环、未完成的数据库连接），会直接卡住启动流程。比如在启动事件里调用天气或比特币价格API时未设置超时，就会一直等待响应。

• 依赖版本不兼容：Uvicorn与FastAPI版本冲突可能引发启动异常。建议升级到最新稳定版：

  pip install --upgrade fastapi uvicorn
  

• 端口被占用：8000端口可能被其他进程占用，导致Uvicorn无法绑定端口。可更换端口启动：

  uvicorn main:app --reload --port 8001
  

  也可通过系统命令排查占用进程：Linux/macOS用lsof -i :8000，Windows用netstat -ano | findstr :8000，找到后关闭对应进程。

• 异步代码处理错误：若应用中使用异步函数但未正确处理同步阻塞逻辑（未用asyncio.to_thread包装），或存在未完成的await操作，会阻塞事件循环导致启动停滞。

• 热重载模式的监听问题：--reload模式下Uvicorn会监听文件变化，若项目目录存在大量文件、符号链接或权限问题，可能导致监听超时卡住。尝试去掉热重载直接启动：

  uvicorn main:app
  

• 启动事件未正常结束：如果启动事件函数是异步的，确保所有异步操作都用await处理；如果是同步函数，确保它能正常返回，不存在无限等待逻辑。

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