Superset从3.0.0升级至4.1.1后MySQL支持缺失问题咨询

问题根源 #

Superset 4.x版本调整了MySQL驱动的检测逻辑，即便安装了pymysql，框架仍优先尝试加载MySQLdb（即mysqlclient）驱动；驱动缺失不仅会触发连接报错，还会导致数据库连接配置页面的UI组件加载失败，出现Basic标签空白的情况。

修复步骤 #

• 更新依赖配置
  修改requirements-local.txt，添加mysqlclient依赖：

  psycopg2-binary
  flask-cors
  flask_openid
  prophet
  pystan
  pymssql
  pymysql
  mysqlclient
  

  mysqlclient是Superset官方推荐的MySQL驱动，兼容性和性能都优于pymysql，能适配4.x版本的依赖检测逻辑。

• 重构Docker镜像并重启服务
  执行命令重新构建镜像（避免缓存）并重启Superset容器：

  docker-compose build --no-cache superset
  docker-compose up -d superset
  

• 修正数据库连接URL格式
  编辑MySQL连接时，使用对应驱动的URL格式：

  • 基于mysqlclient：mysql://<用户名>:<密码>@<主机>:<端口>/<数据库名>
  • 基于pymysql：mysql+pymysql://<用户名>:<密码>@<主机>:<端口>/<数据库名>

• 验证依赖安装状态
  进入容器检查驱动是否安装成功：

  docker exec -it <你的superset容器名> bash
  pip list | grep -E "(mysqlclient|pymysql)"
  

  确认mysqlclient已出现在输出列表中。

补充处理 #

若Basic标签仍为空，清理浏览器缓存后重新访问Superset，避免旧的错误状态缓存导致UI组件加载异常。

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