自定义values.yaml升级Airflow Helm Chart失败求助

核心原因分析 #

迁移日志里的b0d31815b5a6是Airflow的Alembic迁移版本号，出现找不到的情况，通常是两种情况：

1. 现有PostgreSQL数据库的alembic_version表中没有该版本记录，但当前Helm Chart对应的Airflow版本要求必须存在此版本才能继续升级；
2. 迁移Pod的数据库连接配置仍有问题，导致无法正确读取alembic_version表，误报版本不存在。

分步解决方案 #

1. 验证数据库连接有效性 #

即使调整过配置，再做一次精准验证：

• 在集群中启动一个临时PostgreSQL容器用于测试连接：

  kubectl run -it --rm postgres-test --image=postgres:15 -- bash
  

• 进入容器后执行连接命令：

  psql -h <你的PostgreSQL主机地址> -p <端口> -U <Airflow数据库用户名> -d <Airflow数据库名>
  

• 成功登录后查询迁移版本表：

  SELECT * FROM alembic_version;
  

  如果连表都查不到，说明目标数据库未初始化Airflow Schema，需确认是否选错了数据库，或数据库被误重置。

2. 手动补全迁移版本记录 #

如果查询后发现alembic_version表确实没有b0d31815b5a6，且当前升级的Airflow版本依赖该版本，手动插入记录：

INSERT INTO alembic_version (version_num) VALUES ('b0d31815b5a6');

注意：执行前要确认当前Airflow版本的迁移序列中确实包含该版本，可通过查看Airflow代码仓库的alembic/versions目录确认。

3. 跳过钩子强制升级并手动执行迁移 #

若上述步骤无效，且确认数据库状态正常，可尝试跳过Helm迁移钩子强制升级：

helm upgrade <你的Airflow发布名称> apache-airflow/airflow -f values.yaml --skip-hooks

升级完成后手动执行迁移：

• 进入任意Airflow Worker或Scheduler Pod：

  kubectl exec -it <Pod名称> -- bash
  

• 执行迁移命令：

  airflow db upgrade
  

4. 重置迁移历史（极端情况） #

如果数据库状态已混乱，且无重要业务数据，可重置迁移历史：

1. 先备份数据库（必须执行）；
2. 删除Airflow相关的所有表；
3. 重新初始化数据库：

   airflow db init
   

4. 重新执行Helm升级。

额外注意事项 #

• 确认values.yaml中数据库配置的所有参数（postgresql.host、postgresql.port、postgresql.user、postgresql.password、postgresql.database）完全正确，注意密码含特殊字符时的转义问题；
• 检查Azure PostgreSQL的防火墙规则，确保集群Pod能访问数据库端口；
• 跨大版本升级Airflow时，需分步进行，不能直接跳级，避免迁移序列断裂。

内容的提问来源于stack exchange，提问作者pajo-po