Apache Airflow初始化数据库异常：TaskInstance缺失map_index字段

问题根源 #

map_index是Airflow 2.3.x版本支持任务映射（Task Mapping）的核心字段，你的数据库表缺少这个列，说明数据库初始化/迁移过程没有完整执行，导致表结构和当前Airflow版本不匹配。

修复步骤 #

1. 检查迁移状态
   先确认哪些迁移脚本没执行：

   airflow db check-migrations
   

   输出里如果有未应用的迁移，尤其是涉及task_instance表的，就是问题所在。

2. 执行完整数据库迁移
   别再用airflow init db（只适合全新建库），运行迁移命令同步表结构：

   airflow db migrate
   

   这个命令会自动跑所有遗漏的迁移，包括给task_instance表添加map_index列。

3. 验证表结构
   连接Postgres数据库，查看task_instance表：

   \d task_instance;
   

   确认输出里有map_index字段（类型integer，默认值0）。

4. 检查数据库权限
   确保airflow用户有修改表结构的权限，执行以下SQL：

   GRANT ALL PRIVILEGES ON DATABASE airflow TO airflow;
   GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO airflow;
   GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO airflow;
   

5. 极端情况：重建数据库
   如果迁移还是失败，可能是旧数据残留，直接重建：

   DROP DATABASE airflow;
   CREATE DATABASE airflow;
   GRANT ALL PRIVILEGES ON DATABASE airflow TO airflow;
   

   然后重新初始化+迁移：

   airflow db init
   airflow db migrate
   

验证修复 #

重启调度器和Web服务：

airflow scheduler
airflow webserver

再触发DAG，看日志是否还报map_index的错。

内容的提问来源于stack exchange，提问作者Александр М