使用Conduit+Flutter时Docker-Compose无法连接PostgreSQL求助

核心问题分析 #

1. 网络模式冲突：lib服务设置了network_mode: host，导致：
   • 容器共享宿主机网络命名空间，ports映射配置直接失效
   • DB_HOST=127.0.0.1指向容器自身（或宿主机），而非PostgreSQL容器。你手动执行db upgrade成功可能是当时宿主机的5432端口已被PostgreSQL容器映射，但API服务启动时存在连接时序问题，或代码绑定的端口无法被外部访问
2. 启动时序问题：depends_on仅保证PostgreSQL容器先启动，不等待其完全就绪（比如数据库服务初始化完成）
3. API端口绑定限制：如果Dart代码中绑定的是127.0.0.1:8888，在host网络模式下仅能从宿主机本地访问，外部工具无法连接

修复步骤 #

1. 修改docker-compose.yml配置 #

移除host网络模式，改用Docker默认桥接网络，同时配置PostgreSQL健康检查确保服务就绪：

version: '3.8'
services:
  postgres:
    image: postgres:latest
    container_name: postgres_api
    restart: always
    ports:
      - 5432:5432
    environment:
      - POSTGRES_PASSWORD=123
      - POSTGRES_USER=postgres
      - POSTGRES_DB=postgres
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5
    # - PGDATA=/var/lib/postgresql/data/pgdata
  lib:
    restart: on-failure
    container_name: main_api
    build: ./
    # 移除network_mode: host配置
    environment:
      - DB_USERNAME=postgres
      - DB_PASSWORD=123
      - DB_HOST=postgres  # 使用服务名作为主机名，Docker内部DNS可直接解析
      - DB_PORT=5432
      - DB_NAME=postgres
      - SECRET_KEY=SECRET_KEY
    depends_on:
      postgres:
        condition: service_healthy  # 等待PostgreSQL健康检查通过再启动API服务
    ports:
      - 8888:8888
volumes:
  dart_api:

2. 优化Dockerfile（可选但推荐） #

将数据库迁移命令整合到启动流程，避免手动执行：

FROM dart:2.18.6-sdk

WORKDIR /app
COPY pubspec.* ./
RUN dart pub get

COPY . .
RUN dart pub get
RUN dart pub global activate conduit 4.1.6

EXPOSE 8888

# 先执行数据库迁移，再启动API服务
ENTRYPOINT ["sh", "-c", "dart run conduit db upgrade && dart run /app/bin/conduittest.dart conduit:conduit"]

3. 检查Dart API代码的端口绑定 #

确保你的API代码中绑定的是0.0.0.0而非127.0.0.1，这样容器内的服务才能被外部访问：

// 示例代码（根据Conduit框架调整）
void main() async {
  final app = Application<ConduitTestChannel>()
    ..options.configurationFilePath = "config.yaml"
    ..options.port = 8888
    ..options.address = InternetAddress.anyIPv4; // 绑定所有网卡，允许外部访问
  await app.start(numberOfInstances: 1);
}

4. 验证与重启 #

1. 停止并移除现有容器：

   docker-compose down -v
   

2. 重新构建并启动服务：

   docker-compose up --build -d
   

3. 查看容器日志确认服务状态：

   docker-compose logs -f lib
   

4. 使用Postman/Insomnia访问http://<宿主机IP>:8888测试API

额外说明 #

• Docker桥接网络中，服务名（如postgres）可直接作为主机名访问，无需依赖宿主机端口映射
• 健康检查确保PostgreSQL服务完全就绪后再启动API，避免启动时连接失败
• 移除host网络模式后，ports映射生效，外部可正常访问API端口

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