Docker Compose部署Flask+PostgreSQL+Nginx时无法连接数据库求助

我之前也踩过这个一模一样的坑！Docker Compose里服务名称解析的问题大多和启动顺序或者网络配置有关，咱们一步步来排查解决：

1. 最常见的原因：容器启动顺序不匹配 #

Docker Compose的depends_on只会保证PostgreSQL容器在Flask容器之前启动，但不会等PostgreSQL服务完全就绪（比如数据库初始化完成、监听端口打开）。这时候Flask去连接，自然会出现服务名称解析失败或者连接超时的情况。

解决方案：给PostgreSQL加健康检查，让Flask等服务就绪 #

修改你的docker-compose.yml，给PostgreSQL服务添加健康检查，同时让Flask依赖PostgreSQL的健康状态：

version: '3.8'
services:
  postgres:
    image: postgres:14-alpine
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: kftxx2h9mvOqhz3zyLIL-NG7RiUabFEzdCQCNtska-OmeASaSFk3frbKJMVqsZ
      POSTGRES_DB: postgres
    # 健康检查：确认PostgreSQL服务已就绪
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
      interval: 5s  # 每5秒检查一次
      timeout: 5s   # 超时时间5秒
      retries: 5    # 最多重试5次

  flask-app:
    build: ./your-flask-app-path
    environment:
      DATABASE_URL: postgresql://postgres:kftxx2h9mvOqhz3zyLIL-NG7RiUabFEzdCQCNtska-OmeASaSFk3frbKJMVqsZ@postgres:5432/postgres
    depends_on:
      # 只在PostgreSQL健康就绪后启动Flask
      postgres:
        condition: service_healthy

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - flask-app

2. 在Flask代码里添加连接重试逻辑 #

就算有了健康检查，偶尔还是会出现连接波动，在Flask的数据库连接逻辑里加个重试机制更稳妥。比如用psycopg2的话：

import psycopg2
from time import sleep

def get_db_connection():
    max_retries = 5
    retry_count = 0
    while retry_count < max_retries:
        try:
            # 用你提供的连接字符串
            conn = psycopg2.connect(
                "postgresql://postgres:kftxx2h9mvOqhz3zyLIL-NG7RiUabFEzdCQCNtska-OmeASaSFk3frbKJMVqsZ@postgres:5432/postgres"
            )
            print("数据库连接成功！")
            return conn
        except psycopg2.OperationalError as e:
            retry_count += 1
            print(f"连接失败，正在重试（第{retry_count}次）：{str(e)}")
            sleep(2)
    raise Exception("数据库连接失败，已用完所有重试次数")

如果用SQLAlchemy，可以在创建引擎时加上pool_pre_ping=True，让它自动检测并重建失效的连接：

from sqlalchemy import create_engine

engine = create_engine(
    "postgresql://postgres:kftxx2h9mvOqhz3zyLIL-NG7RiUabFEzdCQCNtska-OmeASaSFk3frbKJMVqsZ@postgres:5432/postgres",
    pool_pre_ping=True
)

3. 检查Docker网络配置 #

默认情况下Docker Compose会给所有服务创建一个默认网络，但如果你手动指定了网络，要确保Flask和PostgreSQL在同一个网络里：

# 在docker-compose.yml末尾添加自定义网络
networks:
  app-network:
    driver: bridge

# 给每个服务指定网络
services:
  postgres:
    ...
    networks:
      - app-network
  flask-app:
    ...
    networks:
      - app-network
  nginx:
    ...
    networks:
      - app-network

最后确认小细节 #

• 检查docker-compose.yml里PostgreSQL服务的名称是不是postgres——你的连接字符串里用的是@postgres:5432，服务名称必须完全匹配，大小写敏感！
• 不用给PostgreSQL映射端口到宿主机（除非你需要从宿主机直接连），同一Docker网络里的服务直接用服务名:端口就能访问。

内容的提问来源于stack exchange，提问作者Edgar.A