Docker化Ruby on Rails应用连接Azure托管PostgreSQL数据库问题排查

核心问题定位 #

你的问题根源很明确：

• docker-compose.yml里把数据库连接用的环境变量DB_URL、MEMBER_DB_URL只配置在了冗余的本地postgres服务里，web服务根本没拿到这些变量，导致Rails启动时 fallback 到默认的本地PostgreSQL配置，所以会报找不到Unix套接字的错误。
• 本地postgres服务完全多余，反而可能干扰配置逻辑。

分步解决方案 #

1. 修正docker-compose.yml的环境变量配置

把数据库连接环境变量移到web服务下，同时删除冗余的本地postgres服务。示例配置：

version: '3.8'
services:
  web:
    build: .
    environment:
      - DB_URL=your-azure-app-db-connection-string  # 替换成你的实际连接串
      - MEMBER_DB_URL=your-azure-member-db-connection-string  # 替换成你的实际连接串
      - REDIS_URL=redis://redis:6379/0
    ports:
      - "3000:3000"
    depends_on:
      - redis
  redis:
    image: redis:4.1.4
    ports:
      - "6379:6379"

2. 确认database.yml的配置正确性

确保配置文件完全依赖环境变量，没有硬编码本地数据库的配置。多数据库场景示例：

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

development:
  <<: *default
  url: <%= ENV.fetch("DB_URL") %>

test:
  <<: *default
  url: <%= ENV.fetch("DB_URL") %>

production:
  primary:
    <<: *default
    url: <%= ENV.fetch("DB_URL") %>
  member:
    <<: *default
    url: <%= ENV.fetch("MEMBER_DB_URL") %>
    database_tasks: false  # 如果会员库不需要执行migrations，加上这个

3. 验证Azure PostgreSQL的访问权限

虽然本地PgAdmin和Heroku能连，但要确保Docker宿主机的IP被加入Azure PostgreSQL的防火墙白名单：

• 登录Azure门户，找到你的PostgreSQL服务器
• 进入“连接安全性”选项，添加宿主机的公网IP，或者开启“允许Azure服务和资源访问此服务器”（如果容器用Azure托管的话）

4. 测试容器内的网络连通性

进入web容器，直接用psql测试连接，确认网络和配置没问题：

# 进入web容器（替换成你的容器名）
docker exec -it your-web-container-name bash

# 用环境变量里的连接串测试psql连接
psql $(echo $DB_URL | sed 's/postgres:\/\///')

如果能成功进入psql交互界面，说明连接配置没问题。

5. 重建镜像并重启服务

修改配置后，清理旧镜像并重新部署：

docker-compose build --no-cache
docker-compose up -d

最后进入Rails控制台验证连接：

docker exec -it your-web-container-name rails c
# 测试主数据库连接
ActiveRecord::Base.connection
# 测试会员数据库连接
ActiveRecord::Base.connection_handler.retrieve_connection(:member)

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