安装Apache Superset执行superset db upgrade时遇ModuleNotFoundError错误

问题重现 #

Traceback (most recent call last):
File "C:\Users\ACER\AppData\Local\Programs\Python\Python39\lib\runpy.py", line 197, in _run_module_as_main
return run_code(code, main_globals, None,
File "C:\Users\ACER\AppData\Local\Programs\Python\Python39\lib\runpy.py", line 87, in run_code
exec(code, run_globals)
File "C:\Users\ACER\Virtual_environment\venv\Scripts\superset.exe__main.py", line 4, in
ModuleNotFoundError: No module named 'superset'

可能的原因及解决方案 #

1. 虚拟环境未正确激活 #

• 确认当前终端已激活Superset所在的虚拟环境，Windows系统执行以下命令：

  C:\Users\ACER\Virtual_environment\venv\Scripts\activate.bat
  

  激活成功后终端提示符会显示(venv)前缀，此时重新执行superset db upgrade。

2. Superset未在虚拟环境中正确安装 #

• 若激活虚拟环境后仍报错，重新在虚拟环境内安装Superset：

  pip install apache-superset
  

  安装完成后再次尝试数据库升级命令。

3. 虚拟环境损坏 #

• 若上述操作无效，删除现有虚拟环境并重新创建安装：

  # 删除旧虚拟环境
  rmdir /s C:\Users\ACER\Virtual_environment\venv
  # 创建新虚拟环境
  python -m venv C:\Users\ACER\Virtual_environment\venv
  # 激活新环境
  C:\Users\ACER\Virtual_environment\venv\Scripts\activate.bat
  # 安装Superset
  pip install apache-superset
  

  完成后执行superset db upgrade。

4. Python版本兼容性问题 #

• Superset对Python版本有明确要求，Python 3.9可能存在兼容性冲突，建议切换到Python 3.8或3.10版本，重新创建虚拟环境并安装Superset后再执行命令。

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