使用uvicorn启动FastAPI报错No module named 'firebase_admin'，已装包仍报错如何解决

• 第一步：确认运行环境与依赖安装环境一致
  首先在启动uvicorn的同一终端执行以下命令，确认解释器和依赖安装路径匹配：
  • 查看当前使用的Python解释器路径：
    Linux/macOS执行：which python3
    Windows执行：where python
  • 查看firebase_admin安装路径：pip3 show firebase_admin
    对比返回的Location字段路径是否属于当前Python解释器的site-packages目录。如果使用了虚拟环境，需先确认虚拟环境已激活，再重新安装依赖：

  # 激活虚拟环境示例（venv）
  # Linux/macOS
  source venv/bin/activate
  # Windows
  venv\Scripts\activate
  
  # 重新安装依赖
  pip install firebase_admin uvicorn
  

• 第二步：强制使用当前解释器启动uvicorn
  避免uvicorn绑定全局Python解释器的问题，使用当前Python解释器直接调用uvicorn模块启动服务：
  python -m uvicorn main:app --reload
• 第三步：排查命名冲突
  检查项目根目录及导入路径下是否存在名为firebase_admin.py的本地文件，或同名的目录，Python导入时会优先读取本地文件覆盖第三方包，将冲突的文件/目录重命名后删除__pycache__缓存目录，再重启服务即可。
• 第四步：排查权限问题
  如果之前使用sudo/管理员身份安装的firebase_admin，普通用户身份运行时可能无法读取包文件，使用当前用户身份重新安装即可：
  pip install --user firebase_admin
• 第五步：调试导入路径
  在main.py文件头部加入以下代码，运行后即可确认实际运行时的解释器和导入路径是否符合预期：

  import sys
  print("当前运行的Python解释器路径：", sys.executable)
  print("Python导入搜索路径：", sys.path)
  try:
      import firebase_admin
      print("firebase_admin包路径：", firebase_admin.__file__)
  except ImportError as e:
      print("导入错误：", e)
  

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