Django执行makemigrations/migrate时PostgreSQL连接失败求助

核心问题定位 #

错误提示尝试连接本地PostgreSQL的socket（/var/run/postgresql/.s.PGSQL.5432），说明你的Django配置仍指向本地数据库，而非你所说的在线PostgreSQL。以下是具体排查和修复步骤：

1. 修正DATABASES配置 #

打开项目的settings.py，检查DATABASES['default']的参数：

• 确保HOST设置为在线数据库的远程地址（如云服务商提供的域名/IP），而非空值或localhost
• 确认PORT、NAME、USER、PASSWORD与在线数据库的信息一致

正确配置示例：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'your_db_name',
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_password',
        'HOST': 'remote-db-host.example.com',  # 替换为你的在线数据库地址
        'PORT': '5432',
    }
}

2. 验证远程数据库的可访问性 #

在Fedora终端直接用psql测试连接：

psql -h 远程数据库地址 -U 用户名 -d 数据库名

• 如果连接失败：
  • 检查远程服务器防火墙是否开放5432端口
  • 登录远程数据库服务器，修改pg_hba.conf，添加允许你的Fedora机器IP访问的规则（例如：host all all 你的Fedora_IP/32 scram-sha-256），然后重启PostgreSQL服务
  • 确认在线PostgreSQL服务处于运行状态

3. 排除本地PostgreSQL的干扰 #

如果你之前安装过本地PostgreSQL，可能会导致配置混淆：

• 停止本地PostgreSQL服务：

  sudo systemctl stop postgresql
  

• 重新执行python manage.py migrate，观察错误提示变化：
  • 若错误变为“无法连接到远程地址”，说明配置已修正，问题出在网络/远程数据库的访问权限
  • 若仍提示本地socket错误，说明settings.py的配置未生效（需检查虚拟环境或VSCode终端的配置加载情况）

4. 确认虚拟环境与依赖 #

• 激活项目所用的虚拟环境，执行pip list确认psycopg2-binary已正确安装
• 若使用环境变量配置数据库参数（如os.getenv('DB_HOST')），在VSCode终端执行echo $DB_HOST等命令，确认环境变量已正确加载

5. 测试配置有效性 #

修改配置后，先执行以下命令检查配置是否合法：

python manage.py check

无报错后再重新执行makemigrations和migrate。

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