无密码连接PostgreSQL：命令行正常Python库报错求助

核心原因 #

命令行psql默认通过Unix域套接字连接PostgreSQL，而你在Python代码中指定host=localhost时，psycopg2/SQLAlchemy会使用TCP/IP协议连接。两种连接方式的认证规则在pg_hba.conf中是分开配置的：

• 当pg_hba.conf为空时，PostgreSQL会加载内置默认规则：本地Unix套接字允许peer无密码认证（所以命令行能正常连接），但本地TCP连接要求密码认证（导致Python连接报错）。

解决办法 #

方法1：让Python使用Unix域套接字连接（和psql一致） #

这是最直接的方案，无需修改PostgreSQL配置：

• psycopg2：去掉host参数，或显式指定套接字路径（Ubuntu下默认路径为/var/run/postgresql）：

  # 自动使用Unix套接字
  conn = psycopg2.connect("dbname=dname user=uname")
  
  # 或显式指定套接字路径
  conn = psycopg2.connect("host=/var/run/postgresql dbname=dname user=uname")
  

• SQLAlchemy：省略host部分（用三个斜杠），或通过参数指定套接字路径：

  # 自动使用Unix套接字
  db = sqlalchemy.create_engine('postgresql:///dname')
  
  # 或显式指定套接字路径
  db = sqlalchemy.create_engine('postgresql:///dname?host=/var/run/postgresql')
  

方法2：修改pg_hba.conf，允许本地TCP连接无密码认证 #

如果需要保持Python用TCP连接，可以修改PostgreSQL的认证规则：

1. 找到pg_hba.conf的位置（Ubuntu下通常为/etc/postgresql/<版本号>/main/pg_hba.conf，例如/etc/postgresql/12/main/pg_hba.conf）
2. 编辑文件，添加以下规则（放在文件最顶部，规则匹配从上到下生效）：

   # 允许IPv4本地TCP连接用peer无密码认证
   host    all             all             127.0.0.1/32            peer
   # 允许IPv6本地TCP连接用peer无密码认证
   host    all             all             ::1/128                 peer
   

3. 重启PostgreSQL服务：

   sudo systemctl restart postgresql
   

验证问题根源 #

可以用psql强制走TCP连接测试，确认是否和Python遇到相同问题：

psql -h localhost -d dname -U uname

如果该命令也要求输入密码，即可验证是TCP连接的认证规则导致的问题。

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