PostgreSQL凭证可登录psql但项目连接提示密码验证失败如何解决

• 首先验证不同连接方式的认证差异：执行psql -d DB -U userps -h localhost命令测试带TCP地址的本地登录，输入相同密码观察是否能成功登录。默认不带-h参数的psql命令走本地Unix套接字连接，对应pg_hba.conf的local规则，而程序使用localhost参数默认走TCP连接，对应pg_hba.conf的host规则，两类规则的认证方式配置不同是该类问题最常见诱因。
• 排查连接字符串解析异常：可以放弃使用DATABASE_URL的配置形式，将数据库参数拆分为Django原生配置项，避免URL解析工具的异常导致密码读取错误：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'DB',
        'USER': 'userps',
        'PASSWORD': 'userps',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

替换配置后重启服务测试即可。

• 确认pg_hba.conf配置已生效：修改pg_hba.conf后必须执行重载命令才会生效，常见重载命令为systemctl reload postgresql（系统服务安装方式）或pg_ctl reload（手动编译安装方式）。同时注意pg_hba.conf的规则是从上到下匹配，需保证本地TCP连接的规则优先级高于其他冲突规则，示例合法配置如下：

# IPv4本地连接规则
host    all             all             127.0.0.1/32            scram-sha-256

• 校验密码加密方式与驱动兼容性：执行SQLSELECT rolname, rolpassword FROM pg_authid WHERE rolname = 'userps';查看用户密码的加密格式，如果前缀为SCRAM-SHA-256，需确认Python依赖的psycopg2版本≥2.8，低版本psycopg2不支持SCRAM加密认证会导致密码校验失败，可通过升级psycopg2版本，或修改postgresql.conf的password_encryption参数为md5后重设用户密码解决。
• 查看数据库运行日志定位问题：PostgreSQL默认日志路径为/var/log/postgresql/目录下的日志文件，对应时间点的连接报错条目会明确标注连接来源、匹配的pg_hba规则、认证方式等信息，可以快速定位异常根因。

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