CakePHP 4全新安装后数据库连接失败，配置与报错用户不一致

问题背景 #

你已经确认XAMPP的phpMyAdmin中数据库运行正常，并且配置了如下数据库连接信息：

'default' => [ 
    'className' => 'Cake\Database\Connection', 
    'driver' => 'Cake\Database\Driver\Mysql', 
    'persistent' => false, 
    'host' => 'localhost', 
    'username' => 'root', 
    'password' => '000000', 
    'database' => 'cakephp', 
    'encoding' => 'utf8mb4', 
    'timezone' => 'UTC', 
    'cacheMetadata' => true
]

但CakePHP首页依然弹出错误提示：

CakePHP is NOT able to connect to the database. Connection to database could not be established: SQLSTATE[HY000] [1045] Access denied for user 'my_app'@'localhost' (using password: YES)

排查与解决步骤 #

1. 先确认配置文件是否被正确加载 #

错误里提到的用户名是my_app，但你配置的明明是root——这说明当前生效的配置不是你修改的那一份，这是最常见的原因：

• 核对你修改的配置文件路径：CakePHP 3.x/4.x的数据库配置默认在config/app.php，而config/app_local.php的优先级更高，会覆盖app.php的设置，检查这个文件里是不是还保留着默认的my_app配置。
• 如果你用的是CakePHP 2.x，配置文件在Config/database.php，确认没有其他环境的配置文件（比如database_local.php）干扰。
• 可以做个小测试：故意把配置里的password改成错的，刷新页面看错误提示里的用户名和密码是否变化，如果还是显示my_app，那肯定是加载了错误的配置文件。

2. 验证数据库用户的访问权限 #

就算phpMyAdmin能用root登录，也要确保这个账号能被PHP环境正常访问：

• 打开phpMyAdmin，进入mysql数据库，查看user表，确认root@localhost这个账号存在，并且拥有cakephp数据库的全部权限。
• 用命令行模拟PHP的连接方式，执行：

  mysql -u root -p000000 cakephp
  

  如果能成功进入数据库，说明权限没问题；如果失败，执行以下SQL语句给用户授权：

  GRANT ALL PRIVILEGES ON cakephp.* TO 'root'@'localhost' IDENTIFIED BY '000000';
  FLUSH PRIVILEGES;
  

3. 检查PHP的MySQL扩展是否启用 #

XAMPP默认应该启用了扩展，但偶尔会出现配置问题：

• 访问http://localhost/phpinfo.php，搜索mysqli和pdo_mysql，确认这两个扩展的状态是enabled。
• 如果未启用，找到XAMPP目录下的php.ini文件，取消注释extension=mysqli和extension=pdo_mysql这两行，然后重启Apache服务。

4. 清除CakePHP的配置缓存 #

CakePHP会缓存数据库元数据，就算你修改了配置，旧缓存可能还在生效：

• 找到项目根目录下的tmp/cache/models和tmp/cache/persistent文件夹，删除里面的所有文件（不要删除文件夹本身）。
• 如果你用的是命令行工具，也可以执行：

  bin/cake cache clear_all
  

  来一键清除所有缓存。

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