CakePHP 2.x无法连接PostgreSQL数据库问题求助

你的CakePHP数据库配置如下：

public $default = array(
        'datasource' => 'Database/Postgres',
        'persistent' => false,
        'host' => 'localhost',
        'login' => 'postgres',
        'password' => 'test1234',
        'database' => 'mydatabase',
        'prefix' => '',
        'encoding' => 'utf8',
    ); 

出现的错误提示：

Error: [MissingConnectionException] Database connection "Postgres" is missing, or could not be created.
Exception Attributes: array (
  'class' => 'Postgres',
  'message' => 'SQLSTATE[08006] [7] SCRAM authentication requires libpq version 10 or above',
  'enabled' => true,
);

错误核心是服务器上的libpq库版本低于10，不支持PostgreSQL默认的SCRAM-SHA-256认证方式，以下是两种解决办法：

方案一：升级libpq库 #

• Linux系统：
  • Debian/Ubuntu：执行sudo apt-get update && sudo apt-get install libpq-dev
  • CentOS/RHEL：执行sudo yum install postgresql-devel
• Windows系统：下载安装版本≥10的PostgreSQL客户端（包含libpq组件），安装后确保系统环境变量包含该客户端的bin目录。
• 升级完成后，重启Web服务器（Apache/Nginx等）和CakePHP应用，重新测试连接。

方案二：修改PostgreSQL认证方式为MD5（适合无法升级libpq的场景） #

1. 找到PostgreSQL的pg_hba.conf配置文件：
   • Linux路径通常为/var/lib/postgresql/{你的PostgreSQL版本}/main/pg_hba.conf
   • Windows路径通常为C:\Program Files\PostgreSQL\{你的PostgreSQL版本}\data\pg_hba.conf
2. 编辑文件，将所有使用scram-sha-256的认证行替换为md5：
   原配置示例：

   local   all             postgres                                scram-sha-256
   host    all             all             127.0.0.1/32            scram-sha-256
   host    all             all             ::1/128                 scram-sha-256
   

   修改后：

   local   all             postgres                                md5
   host    all             all             127.0.0.1/32            md5
   host    all             all             ::1/128                 md5
   

3. 重启PostgreSQL服务：
   • Linux：sudo systemctl restart postgresql
   • Windows：打开服务管理器，找到PostgreSQL服务并点击重启
4. 重置postgres用户密码（重新生成MD5哈希）：
   进入psql命令行，执行以下SQL语句：

   ALTER USER postgres WITH PASSWORD 'test1234';
   

5. 重启CakePHP应用，测试数据库连接是否正常。

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