Flask Docker容器无法连接Postgres容器，Oracle VM环境异常

问题概述 #

本地Intel Mac（Docker Compose v2.0.0）上运行正常的Flask+Postgres多容器应用，迁移到Ampere架构Oracle VM（Docker Compose v2.1.1）后出现异常：无需访问数据库的接口可正常响应，调用数据库的接口则超时，返回空响应，Docker日志报WORKER TIMEOUT错误。

关键问题点排查 #

1. psycopg2连接参数错误：
   代码中psycopg2.connect使用host=os.environ.get('DB_HOST')，但DB_HOST是完整的postgresql://user:password@postgres_real:5432/database_name格式URL，psycopg2无法正确解析该格式的host参数，导致连接失败。

2. Postgres未就绪时Flask已启动：
   Docker Compose的depends_on仅保证容器启动顺序，不等待Postgres服务完全初始化。Flask启动后立即尝试连接，此时Postgres可能还未完成就绪，引发连接超时。

3. ARM架构兼容性问题：
   Ampere为ARM64架构，若Flask镜像基于Intel x86编译，或psycopg2未针对ARM64编译，会出现兼容性问题，导致连接异常。

4. iptables规则限制容器间通信：
   当前iptables的FORWARD链仅允许RELATED,ESTABLISHED和wg0接口流量，可能阻断了Docker容器间的网络通信。

解决方案 #

1. 修复psycopg2连接配置 #

选择以下两种方式之一修正连接参数：

• 方式一：直接使用URL连接

conn = psycopg2.connect(os.environ.get('DB_URL'))
# DB_URL格式：postgresql://user:password@postgres_real:5432/database_name

• 方式二：拆分正确参数

# DB_HOST仅设置为容器名：postgres_real
conn = psycopg2.connect(
    host=os.environ.get('DB_HOST'),
    database=os.environ.get('POSTGRES_DB'),
    user=os.environ.get('POSTGRES_USER'),
    password=os.environ.get('POSTGRES_PASSWORD')
)

2. 等待Postgres就绪后启动Flask #

在Docker Compose中为Postgres添加健康检查，并让Flask依赖Postgres的健康状态：

services:
  postgres_real:
    # ...原有配置
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
  backend:
    # ...原有配置
    depends_on:
      postgres_real:
        condition: service_healthy

3. 确保镜像适配ARM64架构 #

• Postgres官方镜像postgres:latest已支持ARM64，无需修改。
• 在Ampere VM上重新构建Flask镜像：执行docker-compose build，确保psycopg2（或psycopg2-binary）针对ARM64编译，避免直接使用Intel环境下构建的镜像。

4. 调整iptables规则允许容器间通信 #

添加允许Docker网络段的FORWARD规则：

# 允许172.23.0.0/16网段双向流量
iptables -A FORWARD -s 172.23.0.0/16 -j ACCEPT
iptables -A FORWARD -d 172.23.0.0/16 -j ACCEPT
# 保存规则（Oracle Linux环境）
iptables-save > /etc/sysconfig/iptables

5. 临时调整Worker超时（可选） #

若Postgres初始化较慢，可临时增加Flask Worker的超时时间（以Gunicorn为例）：

# 在启动命令中添加--timeout参数
gunicorn --bind 0.0.0.0:5000 --timeout 120 app:app

验证步骤 #

1. 停止并重新启动容器：

docker-compose down && docker-compose up --build

2. 测试数据库接口：

curl 0.0.0.0:5000/api/bill/Hello

3. 查看Docker日志，确认无WORKER TIMEOUT错误，接口返回正常数据。

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