Airflow配置MySQL后执行initdb报libmysqlclient.so.18缺失错误的解决求助

从错误回溯栈可以定位，问题出在SQLAlchemy加载MySQLdb驱动时，依赖的系统级共享库 libmysqlclient.so.18 不存在，导致Python无法导入底层的_mysql模块，最终中断Airflow初始化流程。

方案一：安装缺失的系统共享库 #

这是匹配当前驱动版本的直接修复方式，针对你运行的ec2-user所在的Amazon Linux/CentOS类系统，按以下步骤操作：

• 安装MySQL兼容客户端库（该包会提供legacy版本的libmysqlclient.so.18文件）：
  sudo yum install mysql-community-libs-compat
• 刷新系统共享库缓存，让系统能找到新安装的库文件：
  sudo ldconfig
• 快速验证库加载是否正常，执行以下命令确认无报错即代表修复生效：
  python3 -c "import MySQLdb; print('驱动加载正常')"

如果是Ubuntu/Debian类系统，对应执行以下命令安装依赖：

• 安装客户端兼容库：
  sudo apt-get update && sudo apt-get install libmysqlclient21 libmysqlclient-dev
• 刷新共享库缓存：
  sudo ldconfig

方案二：替换为无系统依赖的纯Python驱动 #

如果不想调整系统层面的库配置，可以切换到PyMySQL驱动，完全规避对系统共享库的依赖：

• 安装PyMySQL包：
  pip install pymysql
• 修改airflow.cfg中的sql_alchemy_conn配置项，将原有连接串的mysql+mysqldb 协议头替换为mysql+pymysql，例如：

  修改前：mysql+mysqldb://username:password@mysql-host:3306/airflow?charset=utf8
  修改后：mysql+pymysql://username:password@mysql-host:3306/airflow?charset=utf8

• 重新执行airflow initdb完成初始化流程。

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