Docker部署FastAPI应用连接PostgreSQL失败问题求助

问题详情 #

尝试用Docker Compose为FastAPI应用容器化，但运行compose文件时出现数据库连接错误。错误日志显示连接localhost的5432端口失败，检查发现PostgreSQL容器已监听0.0.0.0:5432，本地直接运行源码无异常。

错误信息 #

执行命令 docker logs api-api-1 得到：

Is the server running on host "localhost" (127.0.0.1) and accepting
        TCP/IP connections on port 5432?
could not connect to server: Cannot assign requested address
        Is the server running on host "localhost" (::1) and accepting
        TCP/IP connections on port 5432?

PostgreSQL容器日志 #

执行命令 docker logs api-postgres-1 得到：

2022-11-22 05:08:23.971 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432

相关配置文件 #

Dockerfile #

FROM python:3.10

WORKDIR /usr/src/app

COPY requirements.txt ./

RUN pip install --no-cache-dir -r requirements.txt 

COPY . .

CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

docker-compose.yaml #

version: '3'
services:
  api:
    image: fastapilearning
    depends_on:
      - postgres
    ports:
      - 80:8000
    environment:
      - ACCESSTOKENEXPIREMINUTE=${ACCESSTOKENEXPIREMINUTE}
      - ALGORITHM=${ALGORITHM}
      - DATABASEHOSTNAME=${DATABASEHOSTNAME}
      - DATABASENAME=${DATABASENAME}
      - DATABASEPASSWORD=${DATABASEPASSWORD}
      - DATABASEPORT=${DATABASEPORT}
      - DATABASEUSERNAME=${DATABASEUSERNAME}
      - SECRETKEY=${SECRETKEY}
    command: /bin/bash -c "alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000"
  
  postgres:
    image: postgres
    environment:
      - POSTGRES_PASSWORD=${DATABASEPASSWORD}
      - POSTGRES_DB=${DATABASENAME}
    volumes:
      - C:\Users\booruledie\Documents\Git\freecodecamp\dockerPostgresData\:/var/lib/postgresql/data

解决方案 #

核心原因 #

Docker Compose的内部网络中，每个容器都是独立的网络节点，localhost对api容器来说指向自身，而非postgres容器。你的环境变量DATABASEHOSTNAME应该被设为了localhost，导致api容器尝试连接自身的5432端口，最终连接失败。

修复步骤 #

1. 修改数据库主机配置：在你的.env文件中，将DATABASEHOSTNAME的值改为postgres（对应compose文件中postgres服务的名称）。Docker Compose会自动在内部网络将服务名解析为对应容器的IP地址。
2. 可选：添加postgres端口映射：如果需要从宿主机直接连接postgres容器调试，可给postgres服务添加端口映射：

   postgres:
     # 保留原有配置
     ports:
       - "5432:5432"
   

3. 处理数据库就绪问题：depends_on仅保证postgres容器先启动，不确保数据库服务完全就绪。可添加健康检查，让api容器在postgres服务可用后再启动：

   postgres:
     # 保留原有配置
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U ${DATABASEUSERNAME} -d ${DATABASENAME}"]
       interval: 5s
       timeout: 5s
       retries: 5
   

   同时修改api服务的depends_on配置：

   api:
     # 保留原有配置
     depends_on:
       postgres:
         condition: service_healthy
   

验证 #

修改完成后，执行docker-compose up --build重新启动服务，api容器即可正常连接到postgres数据库。

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