指定PGPASSFILE后psql仍要求输入密码，请求协助排查

问题现象 #

使用PGPASSWORD环境变量直接传递密码时，psql可以正常连接数据库：

# 通过PGPASSWORD传递密码，连接正常
bash-5.1# PGPASSWORD=P@ssw0rd psql --username=myuser --host=myserver.local --port=5432 --variable database_name=mydb
psql (16.4, server 14.12)
Type "help" for help.
myuser=> exit

但指定PGPASSFILE指向/root/.pgpass后，psql仍然弹出密码输入提示：

# 指定PGPASSFILE后仍要求输入密码
bash-5.1# whoami
root

bash-5.1# ls -al /root/.pgpass
-rw-------. 1 root root 57 Oct 15 12:37 /root/.pgpass

bash-5.1# echo $PGPASSFILE
/root/.pgpass

bash-5.1# cat /root/.pgpass
myserver.local:5432:mydb:myuser:P@ssw0rd

bash-5.1# PGPASSFILE=/root/.pgpass psql --username=myuser --host=myserver.local --port=5432 --variable database_name=mydb
Password for user myuser:

排查步骤 #

• 核对.pgpass文件格式与连接参数的匹配度
  .pgpass的格式严格遵循主机:端口:数据库:用户名:密码，每个字段必须和连接时的参数完全一致：

  • 主机名：确认myserver.local和--host参数完全一致，注意大小写、无多余空格，若存在DNS解析问题，可尝试替换为数据库服务器的IP地址
  • 数据库名：连接命令中的--variable database_name=mydb仅设置psql内部变量，未指定实际连接的数据库，默认会连接与用户名同名的数据库（即myuser）。若要连接mydb，需在命令中添加--dbname=mydb，同时确保.pgpass中的数据库字段为mydb
  • 密码：确保密码中的特殊字符（如@、0）直接原样写入，未被转义

• 检查SELinux上下文（若系统开启SELinux）
  即使文件权限为-rw-------，SELinux的上下文异常也会导致psql无法读取文件：

  1. 执行ls -Z /root/.pgpass查看SELinux上下文，对比其他root目录下的文件（如/root/.bashrc）是否一致
  2. 若上下文异常，执行restorecon -v /root/.pgpass恢复默认上下文

• 调试psql的密码读取过程
  开启调试模式查看详细日志，判断文件是否被读取或匹配失败：

  PGPASSFILE=/root/.pgpass psql --username=myuser --host=myserver.local --port=5432 --variable database_name=mydb -d 2>&1 | grep -i pass
  

• 排查环境变量干扰
  确认PGPASSWORD环境变量未被意外设置（其优先级高于.pgpass）：

  echo $PGPASSWORD
  

  若有输出，执行unset PGPASSWORD后重新测试

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