CakePHP4配置MySQL驱动仍提示SQLite连接失败问题求助

问题根因 #

你遇到的SQLite连接报错和业务侧配置的MySQL数据源无关，是CakePHP 4自带的Debug Kit调试工具栏默认使用SQLite存储调试请求数据，连接失败导致的。你安装的php56-php-pecl-sqlite是适配PHP 5.6的扩展，而CakePHP 4要求PHP版本 >= 7.2，版本不匹配是问题的核心诱因。

解决方案（可按需选择任意一种） #

方案1：修复Debug Kit SQLite依赖（推荐，保留调试工具功能） #

• 先确认当前Web服务运行的PHP版本，执行命令查看：php -v
• 安装对应PHP版本的SQLite扩展，以PHP 7.4为例：

  yum install php74-php-pdo_sqlite php74-php-sqlite3
  

• 重启Web服务/PHP-FPM服务生效
• 给项目临时目录配置正确读写权限，Debug Kit默认在tmp/debug_kit下生成SQLite文件：

  chmod -R 755 /你的项目路径/tmp
  chown -R 你的Web运行用户（如nginx、apache）:用户组 /你的项目路径/tmp
  

方案2：关闭Debug Kit（无需调试场景适用） #

两种操作二选一即可：

• 编辑config/app_local.php，将debug配置项设置为false
• 编辑config/bootstrap.php，注释掉Debug Kit插件加载代码：

  // $this->addPlugin('DebugKit');
  

方案3：自定义Debug Kit使用MySQL存储 #

提前在MySQL中创建名为debug_kit的数据库，然后在config/app_local.php的Datasources配置块中新增专用配置：

'Datasources' => [
    // 保留你原有的default、test数据源配置
    'debug_kit' => [
        'className' => Cake\Database\Connection::class,
        'driver' => Cake\Database\Driver\Mysql::class,
        'host' => 'localhost',
        'username' => '你的MySQL用户名',
        'password' => '你的MySQL密码',
        'database' => 'debug_kit',
        'encoding' => 'utf8mb4',
    ],
],

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