Kubernetes环境下Airflow Pod出现CrashLoopBackOff故障求助

1. 提取核心错误线索 #

• 查看Pod的完整事件日志：kubectl describe pod <airflow-pod-name>，重点关注Events板块的具体报错（如启动命令失败、数据库连接超时、权限拒绝等）
• 调取上一次崩溃的日志详情：kubectl logs <airflow-pod-name> --previous，这部分日志往往能暴露启动失败的根本原因

2. 验证数据库连通性 #

你已在Postgres Pod内执行初始化操作，需确认Airflow Pod能否正常访问数据库：

• 若Airflow Pod能临时启动，进入容器测试连接：

  kubectl exec -it <airflow-pod-name> -- /bin/bash
  psql -h <postgres-service-name> -U <airflow-db-user> -d <airflow-db-name>
  

• 连接失败时排查方向：
  • 确认Postgres Service状态：kubectl get svc，检查服务的ClusterIP、端口是否与Airflow配置匹配
  • 核对Airflow环境变量：比如AIRFLOW__DATABASE__SQL_ALCHEMY_CONN是否正确填写了数据库用户名、密码、地址
  • 检查Postgres的pg_hba.conf配置，确保允许Airflow所在K8s网段的访问请求

3. 检查启动命令与目录权限 #

• 确认Airflow Pod的启动命令是否正确，官方标准启动命令为airflow webserver或airflow scheduler，排查拼写或参数错误
• 验证挂载目录权限：若使用PersistentVolume挂载日志、DAG目录，需确保Airflow进程（默认UID为50000）拥有读写权限，可执行命令查看：

  kubectl exec -it <airflow-pod-name> -- ls -ld <mount-path>
  

  权限不符时，可调整PV/PVC的权限设置，或在Pod的securityContext中指定正确的UID/GID

4. 确认数据库初始化状态 #

进入Postgres Pod，检查Airflow数据库是否完成初始化：

kubectl exec -it <postgres-pod-name> -- psql -U <postgres-user> -d <airflow-db-name>
\dt

若未显示ab_user、dag等Airflow核心表，说明初始化未成功，需重新执行airflow db init，且确保执行时使用的配置指向当前Postgres实例

5. 排查资源限制问题 #

查看Pod的资源配置：kubectl describe pod <airflow-pod-name>，检查Resources板块的CPU、内存请求与限制是否合理。若资源不足导致Pod被OOMKilled，需适当调高资源限制阈值

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