Django从SQLite切换PostgreSQL遇连接拒绝错误求助

我来帮你一步步排查解决这个问题，核心是两个关键点：postgres系统用户缺失导致无法创建数据库，以及Django无法连接PostgreSQL的配置/依赖问题。我们从最基础的环节入手：

第一步：确认PostgreSQL是否正确安装并启动 #

你遇到的「未知用户postgres」提示，大概率是PostgreSQL没有正确安装，或者安装过程中未自动创建系统级的postgres用户。

• 先检查PostgreSQL是否已安装：

  psql --version
  

  如果没有输出版本信息，说明尚未安装，根据你的系统选择对应命令安装：

  • Ubuntu/Debian：

    sudo apt update && sudo apt install postgresql postgresql-contrib
    

  • CentOS/RHEL：

    sudo dnf install postgresql-server postgresql-contrib
    sudo postgresql-setup --initdb  # 必须执行初始化
    

  • macOS（Homebrew安装）：

    brew install postgresql
    brew services start postgresql
    

    注意：Homebrew安装的PostgreSQL不会创建postgres系统用户，直接用当前用户身份运行psql即可，无需sudo -u postgres

• 安装完成后启动服务并设置开机自启：

  # 适用于Ubuntu/Debian/CentOS
  sudo systemctl start postgresql
  sudo systemctl enable postgresql
  

第二步：创建Django所需的数据库与用户 #

当PostgreSQL服务正常运行后，我们需要创建配置文件里指定的数据库和权限用户：

针对Linux系统（存在postgres系统用户的情况） #

如果sudo -u postgres psql能正常进入psql终端，执行以下SQL命令：

-- 创建zorgan用户，密码要和settings里的DB_PASSWORD完全一致
CREATE USER zorgan WITH PASSWORD '你的数据库密码';
-- 创建指定数据库，并设置zorgan为所有者
CREATE DATABASE "db.postr" OWNER zorgan;
-- 赋予用户该数据库的全部操作权限
GRANT ALL PRIVILEGES ON DATABASE "db.postr" TO zorgan;
-- 退出psql终端
\q

针对macOS（Homebrew安装） #

直接运行psql进入终端，执行上面的SQL命令即可（无需切换用户）。

第三步：检查Django的配置与依赖 #

接下来确认Django的连接配置和依赖是否正确：

1. 安装PostgreSQL驱动：
   Django需要psycopg2来连接PostgreSQL，执行以下命令安装预编译版本（避免源码编译的麻烦）：

   pip install psycopg2-binary
   

2. 验证settings.py的数据库配置：
   你的配置框架没问题，但要注意几个细节：

   • NAME字段为"db.postr"，要确保你创建的数据库名和这个完全一致（包括点号，PostgreSQL允许带点的数据库名，但需注意引号）
   • PASSWORD用了config('DB_PASSWORD')，要确认环境变量或.env文件（如果用了django-environ）里已经设置了正确的DB_PASSWORD值
   • PORT留空会使用默认的5432端口，确保PostgreSQL确实在监听这个端口

第四步：测试连接并运行迁移 #

先手动测试数据库连接是否正常：

# Linux系统
psql -U zorgan -d "db.postr" -h localhost
# macOS系统（当前用户为zorgan时）
psql -d "db.postr"

如果能成功进入psql终端，说明数据库连接没问题。回到Django项目目录，运行：

python manage.py makemigrations
python manage.py migrate

额外排查点（如果仍出现连接拒绝） #

如果还是报错，检查以下配置：

• 打开PostgreSQL的postgresql.conf配置文件（Linux一般在/etc/postgresql/<版本>/main/，macOS Homebrew安装在/usr/local/var/postgres/），确认listen_addresses = 'localhost'没有被注释
• 检查pg_hba.conf文件，确保有允许localhost连接的规则，比如：

  host    all             all             127.0.0.1/32            scram-sha-256
  

  修改后重启PostgreSQL服务：sudo systemctl restart postgresql

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