Docker容器已启动但Localhost无法访问，Rails连PostgreSQL失败

一、先解决PostgreSQL连接失败问题 #

你遇到的activeRecord::ConnectionNotEstablished错误，核心原因是Rails容器默认尝试用本地Unix套接字连接PostgreSQL，但PostgreSQL是单独的容器，必须用TCP跨容器连接。

1. 修正database.yml配置 #

把数据库连接的主机改成Docker Compose里PostgreSQL服务的名称（比如你的postgres服务叫db），不要用本地套接字路径：

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  host: db  # 这里填docker-compose.yml里postgres服务的名称
  username: <%= ENV.fetch("POSTGRES_USER") %>
  password: <%= ENV.fetch("POSTGRES_PASSWORD") %>
  port: 5432 # PostgreSQL默认端口

development:
  <<: *default
  database: your_app_development

test:
  <<: *default
  database: your_app_test

也可以直接用DATABASE_URL环境变量简化配置，避免重复写参数。

2. 完善docker-compose.yml的PostgreSQL及Rails服务配置 #

• 给PostgreSQL服务加健康检查，确保数据库完全就绪后再启动Rails：

services:
  db:
    image: postgres:15-alpine
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    environment:
      POSTGRES_USER: your_db_user
      POSTGRES_PASSWORD: your_db_pass
      POSTGRES_DB: your_app_development # 可选，预创建开发库
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U your_db_user -d your_app_development"]
      interval: 5s
      timeout: 5s
      retries: 5

• 给Rails服务加依赖和正确的启动命令，确保绑定0.0.0.0：

rails_api:
    build: ./path/to/your/rails/api
    volumes:
      - ./path/to/your/rails/api:/app
    ports:
      - "3001:3000" # 本地端口:容器内Rails端口（默认3000）
    environment:
      RAILS_ENV: development
      POSTGRES_USER: your_db_user
      POSTGRES_PASSWORD: your_db_pass
      DATABASE_URL: postgres://your_db_user:your_db_pass@db:5432/your_app_development
    depends_on:
      db:
        condition: service_healthy # 等数据库健康检查通过再启动
    command: bundle exec rails s -b 0.0.0.0 # 绑定所有IP，允许外部访问

二、解决端口访问无响应问题 #

容器启动但localhost端口无法访问，按以下步骤排查：

1. 确认Rails绑定了正确的地址 #

Rails默认只绑定容器内的localhost，外部无法访问，必须启动时指定-b 0.0.0.0（如上配置），或者在config/puma.rb里设置bind 'tcp://0.0.0.0:3000'。

2. 检查端口映射是否匹配 #

比如你访问localhost:3001，docker-compose里的Rails服务必须有ports: - "3001:3000"，确保本地端口和容器内Rails监听的端口对应。

3. 验证容器内应用是否正常运行 #

进入容器执行curl localhost:3000，如果容器内都访问不了，说明应用没真正启动——即使日志没报错，也可能是依赖未安装、配置文件语法错误等问题，仔细看容器启动日志：docker compose logs rails_api。

4. 检查本地端口占用或防火墙 #

用lsof -i :3001（Mac/Linux）或netstat -ano | findstr :3001（Windows）检查端口是否被其他程序占用，或者本地防火墙是否拦截了该端口。

三、额外排查点 #

• 测试容器间网络连通性：docker compose exec rails_api ping db，如果ping不通，说明网络配置有问题，检查所有服务是否在同一个Docker网络（默认compose会创建统一网络）。
• 检查Strapi能访问的原因：对比Strapi的配置，看它的数据库连接、端口绑定、启动命令和Rails服务的差异，往往能找到问题点。

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