使用psycopg2将WSGI应用连接PostgreSQL时密码认证失败该如何解决？

结论 #

不需要在root用户账户下为Apache/WSGI新建PostgreSQL数据库，你遇到的密码认证失败问题和Apache运行身份无关，90%以上的概率是PostgreSQL的客户端认证配置规则导致的。

常见原因与解决步骤 #

• 首先排查PostgreSQL的pg_hba.conf配置：
  这个文件控制PostgreSQL的客户端接入规则，默认情况下本地连接（包括Unix套接字、本地TCP请求）会采用peer/ident认证模式，该模式会要求发起请求的操作系统用户名和你传入的PostgreSQL用户名完全一致，哪怕你传入了正确的密码也会直接拒绝认证，这是你报错的核心原因。
  1. 找到pg_hba.conf文件，常见路径：
     • Debian/Ubuntu系：/var/lib/postgresql/<PG版本号>/main/pg_hba.conf
     • CentOS/RHEL系：/var/lib/pgsql/<PG版本号>/data/pg_hba.conf
  2. 找到对应本地连接的规则行，将认证方式改为md5开启密码认证：

     # 修改前
     local   all             all                                     peer
     host    all             all             127.0.0.1/32            ident
     # 修改后
     local   all             all                                     md5
     host    all             all             127.0.0.1/32            md5
     

  3. 重启PostgreSQL服务生效：systemctl restart postgresql
• 如果修改后仍报错，按以下顺序排查：
  1. 直接在服务器本地用命令行测试连接，确认密码有效性：psql -U username -d mydatabase -h localhost，如果这里也报密码错误，说明你确认的密码/用户名/库名确实有误。
  2. 确认你直接用Python运行测试代码可以正常连接，排除代码参数错误问题。
  3. 若本地运行代码正常，Apache WSGI模式下报错，可在连接参数里显式指定host='127.0.0.1'强制走TCP连接，避免Unix套接字触发peer认证规则。

额外优化建议 #

你当前的测试代码在模块全局位置创建数据库连接，WSGI模式下会出现连接复用异常，生产环境建议将连接创建逻辑放到请求处理函数内部，或者使用数据库连接池管理连接。

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