Docker环境下Rust(Actix Web)连接PostgreSQL(SQLx)报错求助

错误原因分析 #

1. 使用postgres主机名时解析失败 #

该错误表明Rust容器无法识别PostgreSQL服务的主机名，常见触发因素包括：

• Docker网络配置异常，两个服务未处于同一网络环境
• depends_on仅保证容器启动顺序，不等待PostgreSQL服务完全初始化就绪
• 环境变量传递错误，导致数据库连接参数不匹配

2. 使用localhost时连接被拒绝 #

容器内的localhost指向容器自身，而非宿主机或PostgreSQL容器，因此无法跨容器建立连接。

分步解决方案 #

1. 配置正确的数据库连接地址 #

在项目根目录的.env文件中，确保DATABASE_URL使用PostgreSQL服务名作为主机名：

DATABASE_URL=postgres://postgres:secret@postgres:5432/postgres
DATABASE_NAME=postgres
DATABASE_USER=postgres
DATABASE_PASSWORD=secret
DATABASE_PORT=5432
APP_PORT=8080

同时保证PostgreSQL服务的环境变量与上述配置完全匹配。

2. 添加健康检查，等待PostgreSQL就绪 #

修改compose.yml中的PostgreSQL服务配置，添加健康检查逻辑，确保Rust服务仅在PostgreSQL完全启动后才运行：

postgres:
  container_name: postgres
  image: postgres:latest
  environment:
    POSTGRES_DB: ${DATABASE_NAME}
    POSTGRES_USER: "${DATABASE_USER}"
    POSTGRES_PASSWORD: "${DATABASE_PASSWORD}"
  ports:
    - "${DATABASE_PORT}:${DATABASE_PORT}"
  volumes:
    - db-store:/var/lib/postgresql/data
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U ${DATABASE_USER} -d ${DATABASE_NAME}"]
    interval: 5s
    timeout: 5s
    retries: 5

更新Rust服务的depends_on配置，依赖PostgreSQL的健康状态：

backend:
  container_name: backend-rust
  build:
    context: .
    dockerfile: Dockerfile
    args:
      DATABASE_URL: "${DATABASE_URL}"
  volumes:
    - .:/gamernage
  working_dir: /gamernage
  environment:
    DATABASE_URL: "${DATABASE_URL}"
  depends_on:
    postgres:
      condition: service_healthy
  ports:
    - "${APP_PORT}:${APP_PORT}"

3. 确保容器在同一网络（可选但推荐） #

显式声明Docker网络，避免默认网络可能出现的异常：
在compose.yml最外层添加网络配置：

networks:
  app-network:
    driver: bridge

给两个服务添加网络关联：

backend:
  # ...其他配置
  networks:
    - app-network

postgres:
  # ...其他配置
  networks:
    - app-network

4. 适配开发模式的运行命令（针对本地调试） #

由于你挂载了本地代码目录到容器中，开发阶段建议使用cargo run而非预构建的二进制，修改Rust服务的command：

backend:
  # ...其他配置
  command: cargo run

验证连接 #

启动服务后，可进入Rust容器测试网络连通性：

docker exec -it backend-rust ping postgres

如果能正常ping通，说明网络配置正确，再检查数据库连接逻辑即可。

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