Airflow首次initdb卡在“add max tries column to task instance”迁移步骤求助

这种情况确实挺反常的——空数据库初始化居然卡在迁移步骤，而且耗时超过一小时，我来分享几个大概率能排查出问题的方向和解决办法：

1. 检查MSSQL驱动与依赖版本兼容性 #

Airflow对MSSQL的支持依赖pyodbc库，版本不匹配很容易导致迁移脚本执行异常：

• 如果你用的是Airflow 1.x（因为你用了initdb命令，2.x版本对应的是db init），建议把pyodbc降级到4.0.x系列（比如4.0.32），避免使用5.x以上的新版本，这类版本对旧版MSSQL的兼容性可能存在问题。执行命令：

  pip install pyodbc==4.0.32
  

• 确认你的SQLAlchemy连接串里指定的ODBC驱动版本正确，MSSQL 2016推荐用ODBC Driver 17 for SQL Server，连接串示例：

  sql_alchemy_conn = mssql+pyodbc://your_user:your_pwd@your_server/airflow_db?driver=ODBC+Driver+17+for+SQL+Server
  

2. 排查数据库连接与服务器资源问题 #

哪怕能启动迁移，连接性能或服务器资源不足也会导致卡住：

• 先停止当前的airflow initdb进程，然后用SSMS登录MSSQL服务器，执行sp_who2或者查询sys.dm_exec_requests视图，看看有没有阻塞的会话，或者Airflow的连接进程是否在等待锁、IO等资源。
• 检查数据库服务器的CPU、内存使用率，如果资源被占满，迁移脚本自然会卡住。

3. 查看Airflow调试日志定位具体卡点 #

开启调试日志重新执行初始化，能拿到更详细的报错信息：

airflow initdb -l DEBUG

从日志里你可以看到迁移脚本具体卡在哪个SQL语句上——比如这次的迁移是给task_instance表加max_tries列，空库下应该是创建表时附带这个字段，日志里会显示执行的SQL，你可以手动在SSMS里执行这条SQL，看看是否会报错或卡住。

4. 考虑Airflow版本的迁移bug #

某些旧版Airflow（比如1.10.x早期版本）针对MSSQL的迁移脚本存在死锁或无限等待的bug：

• 如果用的是旧版Airflow，建议升级到同系列的最新补丁版本（比如1.10.15），这些版本通常会修复数据库迁移的兼容性问题。
• 如果你愿意升级到Airflow 2.x，记得用airflow db init代替initdb，2.x对MSSQL的支持更完善。

最后，因为是首次初始化，你可以先删除数据库里已经创建的所有表（反正都是空的），然后按照上面的调整重新执行airflow initdb，大概率能解决问题。

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