pgAdmin 3可连PostgreSQL，Laravel报用户密码认证失败求助

既然pgAdmin能正常连接，说明你的PostgreSQL服务、用户账号和密码本身是没问题的，问题大概率出在Laravel的配置细节或者PostgreSQL的连接权限设置上，咱们一步步排查：

• 仔细核对.env文件的配置
  先确认.env里的数据库配置项有没有写错，尤其是容易忽略的细节：

  DB_CONNECTION=pgsql
  DB_HOST=localhost  # 要和pgAdmin里填写的主机地址完全一致，比如是localhost就别写127.0.0.1
  DB_PORT=5432
  DB_DATABASE=你的目标数据库名
  DB_USERNAME=khrisna
  DB_PASSWORD=你的用户密码
  

  重点注意：

  • 如果密码包含特殊字符（比如!@#$%^&*()或者空格），一定要用双引号把密码包裹起来，比如DB_PASSWORD="my!pass#123"，否则Laravel会解析错误。
  • 检查密码的大小写是否正确（PostgreSQL的密码是严格区分大小写的），以及有没有不小心在密码前后多打了空格。

• 清除Laravel的配置缓存
  如果你之前执行过php artisan config:cache，Laravel会把配置文件缓存起来，之后修改.env的内容不会实时生效。解决方法是运行以下命令：

  php artisan config:clear
  php artisan cache:clear
  

  执行完成后再尝试连接，看看问题是否解决。

• 检查PostgreSQL的pg_hba.conf权限配置
  PostgreSQL通过pg_hba.conf文件控制不同主机的连接认证方式，你需要确认Laravel的连接方式被允许：

  1. 找到pg_hba.conf的位置：Linux系统通常在/var/lib/postgresql/对应版本/main/pg_hba.conf，Windows系统一般在C:\Program Files\PostgreSQL\对应版本\data\pg_hba.conf。
  2. 查看文件中本地连接的配置条目，确保类似下面的设置：

     # IPv4本地连接
     host    all             all             127.0.0.1/32            md5
     # IPv6本地连接
     host    all             all             ::1/128                 md5
     

     要保证127.0.0.1/32或localhost对应的认证方式是md5（密码认证），如果是peer或ident，Laravel用密码连接就会失败。
  3. 修改完成后，记得重启PostgreSQL服务让配置生效。

• 确认PostgreSQL用户的连接主机权限
  检查khrisna用户是否允许从Laravel所在的主机连接：
  用pgAdmin登录后，执行以下SQL语句：

  SELECT usename, host FROM pg_user;
  

  如果khrisna用户的host字段是localhost，那Laravel用127.0.0.1连接可能会被拒绝，反之亦然。可以修改用户的连接权限：

  -- 允许从任意主机连接（生产环境建议指定具体主机，避免安全风险）
  ALTER USER khrisna WITH HOST '%';
  -- 同时重置一次密码确保同步
  ALTER USER khrisna WITH PASSWORD '你的用户密码';
  

• 检查Laravel的database.php配置文件
  有时候.env的配置会被config/database.php里的硬编码覆盖，检查pgsql部分的配置：

  'pgsql' => [
      'driver' => 'pgsql',
      'url' => env('DATABASE_URL'),
      'host' => env('DB_HOST', '127.0.0.1'),
      'port' => env('DB_PORT', '5432'),
      'database' => env('DB_DATABASE', 'forge'),
      'username' => env('DB_USERNAME', 'forge'),
      'password' => env('DB_PASSWORD', ''),
      'charset' => 'utf8',
      'prefix' => '',
      'prefix_indexes' => true,
      'search_path' => 'public',
      'sslmode' => 'prefer',
  ],
  

  确保这里的配置都是读取.env的变量，没有硬写错误的用户名或密码。

按照上面的步骤排查，应该能快速定位问题。我之前碰到过好几次都是因为配置缓存或者.env里的密码没加引号导致的，建议先从这两个方向入手排查。

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