Docker部署Rails项目无法连接PostgreSQL数据库问题求助

问题核心原因 #

你当前的配置存在两个关键错误：

1. 初始配置中DATABASE_HOST设为localhost：Docker容器内的localhost指向容器自身，而非宿主机或同网络下的其他容器，Rails容器内部没有运行PostgreSQL服务，自然连接失败。
2. 即使修改了数据库主机为abc-db，DATABASE_PORT配置错误：你配置的5435是PostgreSQL容器映射到宿主机的端口，仅供给宿主机上运行的工具（如Psequel）访问使用；同Docker bridge网络内的容器通信，需要使用PostgreSQL容器内部暴露的端口5432。

可行修复步骤 #

1. 修改docker-compose.yml中testproject服务的环境变量配置：

environment: 
  DATABASE_HOST: abc-db # 取消注释该行，注释localhost配置
  DATABASE_USER: test
  DATABASE_PASSWORD: testpass
  DATABASE_NAME: abc
  DATABASE_PORT: 5432 # 把端口从5435改成5432
  LOCAL_TESTS: 1

2. 检查Rails项目的config/database.yml配置，确认数据库连接字段优先读取环境变量，没有写死host、port值：

development:
  host: <%= ENV.fetch("DATABASE_HOST") %>
  port: <%= ENV.fetch("DATABASE_PORT") %>
  username: <%= ENV.fetch("DATABASE_USER") %>
  password: <%= ENV.fetch("DATABASE_PASSWORD") %>
  database: <%= ENV.fetch("DATABASE_NAME") %>

3. 重启docker-compose服务，生效配置：

docker-compose down
docker-compose up -d

验证方法 #

如果修复后仍然连接失败，进入Rails容器逐层排查：

• 执行ping abc-db，确认网络可以连通数据库容器
• 执行nc -zv abc-db 5432，确认数据库容器的5432端口可访问
• 执行psql -h abc-db -p 5432 -U test abc，输入密码testpass，确认可以直接通过命令行连接数据库

附加优化建议 #

depends_on仅保证容器启动顺序，不会等待PostgreSQL服务完全初始化完成，你可以在Rails容器的启动命令前添加端口等待逻辑，避免启动时偶发的连接失败，示例：

command: sh -c "wait-for-it abc-db:5432 -- bundle exec rails s -b 0.0.0.0"

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