基于RedHat UBI8镜像部署Airflow：无法连接PostgreSQL

1. 系统依赖缺失（最可能原因） #

Red Hat UBI8 基础镜像默认不包含 PostgreSQL 客户端相关系统库，而 psycopg2（Airflow 连接 PostgreSQL 的核心依赖）运行时需要依赖 libpq.so 等系统库，编译版本还需要对应头文件。Debian 基础镜像通常预装了这些依赖，因此之前的版本能正常运行。

解决方法：
在 Dockerfile 的 pip install 步骤前，添加系统依赖安装命令：

USER root
# 若使用 psycopg2-binary，安装运行时依赖即可
RUN dnf install -y postgresql-libs && dnf clean all

# 若为编译安装 psycopg2（非binary版本），需额外安装编译依赖
# RUN dnf install -y gcc postgresql-devel && dnf clean all
USER airflow

2. 数据库检测脚本依赖缺失 #

如果你的 entrypoint.sh 中使用了 pg_isready 命令检测 PostgreSQL 连接状态，该命令属于 postgresql-client 包，UBI8 镜像默认未安装，会导致检测逻辑失败（即使实际数据库能连通）。

解决方法：

• 方法一：在 Dockerfile 中安装 postgresql-client：

USER root
RUN dnf install -y postgresql-client && dnf clean all
USER airflow

• 方法二：替换检测逻辑为纯 Python 脚本，避免依赖系统命令，示例修改 entrypoint.sh 中的检测段：

count=1
until python -c "import psycopg2; psycopg2.connect('postgresql+psycopg2://airflow:airflow@label-postgres:5432/airflow')"; do
    echo "waiting for Postgres(label-postgres:5432)... $((count++))/20"
    sleep 5
done

3. SELinux 策略限制（可能性较低） #

若宿主机为 Red Hat/CentOS 系统，SELinux 可能限制容器网络连接。可临时关闭 SELinux 测试：

setenforce 0

若测试后恢复正常，可配置 SELinux 允许容器网络连接，或在 Docker Compose 中添加 security_opt: ["label=disable"] 禁用容器的 SELinux 标签。

4. 文件权限调整 #

UBI8 镜像对文件权限要求更严格，需确保启动脚本有可执行权限：
在 Dockerfile 中添加：

RUN chmod +x /entrypoint.sh /start.sh

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