Apache Superset 4.1.1版本升级中的MySQL连接问题解决方案

在将Apache Superset从4.0.1版本升级到4.1.1版本的过程中，许多用户在使用Helm charts部署时会遇到MySQL连接相关的Python模块错误。本文将详细分析问题原因并提供完整的解决方案。

问题背景

当用户尝试通过Helm charts在AKS上部署Apache Superset 4.1.1版本时，系统会抛出关于MySQL Python模块的错误。具体表现为：

1. 缺少pkg-config工具
2. 无法找到有效的pkg-config名称
3. 最终导致"ModuleNotFoundError: No module named 'mysql'"错误

根本原因分析

从Superset 4.1.0版本开始，开发团队为了创建更精简的Docker镜像，有意移除了包括MySQL在内的数据库驱动程序。这一变化意味着：

1. 基础镜像不再包含MySQL连接所需的系统依赖
2. Python环境中缺少mysql-connector等关键模块
3. 需要手动安装这些依赖才能正常使用MySQL数据库连接功能

完整解决方案

1. 修改Helm values文件

在dev-values.yaml文件中添加以下bootstrapScript配置：

bootstrapScript: |
  #!/bin/bash
  # 更新系统包并安装依赖
  apt update && apt install -y gcc libpq-dev python3-dev pkg-config default-libmysqlclient-dev && \
  
  # 安装Python依赖
  pip install \
    psycopg2==2.9.6 \
    azure.core \
    azure.identity \
    mysqlclient \
    mysql-connector

2. 关键组件说明

1. 系统依赖:

   • gcc: C编译器，用于编译Python扩展
   • libpq-dev: PostgreSQL开发库
   • python3-dev: Python开发头文件
   • pkg-config: 用于查询已安装库的工具
   • default-libmysqlclient-dev: MySQL客户端开发库

2. Python包:

   • psycopg2: PostgreSQL适配器
   • mysqlclient: MySQL数据库连接器
   • mysql-connector: 官方MySQL连接器

3. 注意事项

1. 在某些Debian/Ubuntu版本中，libmysqlclient-dev已被替换为default-libmysqlclient-dev或libmariadb-dev
2. 如果使用MySQL官方连接器，需要确保安装的是mysql-connector而非旧版的mysql-connector-python
3. 对于生产环境，建议将这些依赖固化到自定义Docker镜像中，而不是每次启动时安装

实施效果

应用上述解决方案后：

1. 系统将正确识别MySQL连接所需的依赖
2. Python环境中将包含所有必要的数据库连接模块
3. Superset应用能够正常初始化并与MySQL数据库建立连接

最佳实践建议

1. 对于生产环境，建议创建自定义Docker镜像，将这些依赖固化到镜像中
2. 定期检查依赖版本，确保与Superset版本的兼容性
3. 在升级前，先在测试环境验证所有数据库连接功能
4. 考虑使用requirements.txt或Pipfile管理Python依赖

通过以上步骤，用户可以顺利完成Superset 4.1.1版本的升级，并确保MySQL数据库连接功能正常工作。