Win7+Docker环境下Rails项目从SQLite转PostgreSQL遇连接错误

我帮你分析下这个问题，你遇到的连接错误核心原因是：在Docker Compose的多容器环境里，你的Rails（web）容器和PostgreSQL容器是相互独立的，Rails默认尝试用本地Unix套接字连接PostgreSQL，但这个套接字只存在于PostgreSQL容器内部，web容器根本访问不到。咱们一步步来解决：

第一步：确认Docker Compose的PostgreSQL服务配置 #

首先检查你的docker-compose.yml，确保postgres服务的定义是正确的，比如下面的示例配置：

version: '3'
services:
  web:
    build: .
    command: bundle exec rails s -p 3000 -b '0.0.0.0'
    volumes:
      - .:/app
    ports:
      - "3000:3000"
    depends_on:
      - postgres # 确保web服务依赖postgres服务
  postgres:
    image: postgres:10-alpine # 可根据你的Rails版本选择合适的PostgreSQL镜像
    volumes:
      - postgres_data:/var/lib/postgresql/data/ # 持久化数据库数据
    environment:
      POSTGRES_PASSWORD: my_secure_password # 设置PostgreSQL的root密码
volumes:
  postgres_data:

关键是要保证web服务的depends_on包含postgres，这样Docker会先启动PostgreSQL容器再启动web容器。

第二步：修正database.yml的连接配置 #

接下来修改config/database.yml，把连接方式从本地套接字改成TCP连接，指定PostgreSQL容器的服务名作为host：

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  host: postgres # 这里用Docker Compose的postgres服务名，会自动解析为容器IP
  username: postgres # PostgreSQL默认的管理员用户名
  password: my_secure_password # 要和docker-compose.yml里的POSTGRES_PASSWORD一致

development:
  <<: *default
  database: my_database_development

test:
  <<: *default
  database: my_database_test

production:
  <<: *default
  database: my_database_production
  # 生产环境建议用环境变量管理密码，避免硬编码
  password: <%= ENV['POSTGRES_PASSWORD'] %>

这里的host: postgres是关键，它会让Rails通过Docker内部网络的TCP连接访问PostgreSQL容器的5432端口，而不是去找本地的Unix套接字。

第三步：重新构建并执行数据库创建命令 #

完成配置修改后，先清理旧容器，再重新构建启动：

# 停止并移除所有容器
docker-compose down
# 重新构建web服务镜像
docker-compose build
# 先启动postgres容器，等待服务就绪
docker-compose up -d postgres
# 等待3-5秒，让PostgreSQL完全启动（可通过日志确认）
docker-compose logs postgres | grep "ready to accept connections"
# 执行数据库创建命令
docker-compose run web rails db:create

这里特意先启动postgres容器并等待它就绪，因为depends_on只保证启动顺序，不保证服务完全可用，直接执行db:create可能会因为PostgreSQL还没初始化完成报错。

额外排查点 #

如果还是报错，可以检查：

• 查看PostgreSQL容器的日志，确认服务是否正常启动：docker-compose logs postgres
• 确认web容器能ping通postgres服务：docker-compose run web ping postgres，如果能ping通说明网络没问题
• 检查database.yml里的密码是否和docker-compose.yml的POSTGRES_PASSWORD完全一致

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