Local By Flywheel Linux环境下WP-CLI数据库连接错误求助（网站可正常访问）

核心原因是Web服务器环境和CLI环境的配置差异，以下是针对性的排查和解决步骤：

1. 核对Web与CLI使用的PHP版本及扩展 #

Web和CLI可能用了不同的PHP版本，导致数据库扩展（如mysqli、pdo_mysql）在CLI环境未启用：

• 查看Web的PHP信息：在网站根目录新建phpinfo.php，内容<?php phpinfo(); ?>，访问后记录PHP版本和已启用的数据库扩展。
• 查看CLI的PHP信息：执行php -v（看版本）和php -m（看已加载扩展）。
• 如果版本不一致，切换CLI到Web使用的PHP版本（比如用/usr/bin/php7.4代替php执行WP-CLI命令）；如果扩展缺失，在CLI的PHP配置中启用对应扩展。

2. 检查wp-config.php中的环境依赖代码 #

有些配置会依赖Web环境变量（如$_SERVER['HTTP_HOST']）切换数据库配置，CLI环境下这些变量不存在，导致加载错误配置：

• 打开wp-config.php，查找类似以下的条件判断：

  if (isset($_SERVER['HTTP_HOST']) && $_SERVER['HTTP_HOST'] === 'example.com') {
      define('DB_NAME', 'prod_db');
  } else {
      define('DB_NAME', 'wrong_db');
  }
  

• 解决方法：要么把数据库配置写死（去掉条件判断），要么给CLI环境单独配置：

  if (defined('WP_CLI')) {
      // CLI专属数据库配置
      define('DB_NAME', 'your_db');
      define('DB_USER', 'your_user');
      define('DB_PASSWORD', 'your_pass');
      define('DB_HOST', '127.0.0.1');
  } else {
      // Web环境配置
      define('DB_NAME', 'your_db');
      // ... 其他Web配置
  }
  

3. 直接测试CLI环境的数据库连接 #

写一个简单的PHP脚本验证CLI能否连上数据库，排除WP-CLI本身的问题：
创建test-db.php，内容如下：

<?php
$db_host = '你的DB_HOST';
$db_user = '你的DB_USER';
$db_pass = '你的DB_PASSWORD';
$db_name = '你的DB_NAME';

// 用mysqli测试
$conn = mysqli_connect($db_host, $db_user, $db_pass, $db_name);
if (!$conn) {
    die('连接失败: ' . mysqli_connect_error());
}
echo '数据库连接成功';
mysqli_close($conn);
?>

执行php test-db.php，如果报错：

• 若提示"Access denied"：检查数据库用户是否允许从CLI所在的主机（如localhost、127.0.0.1）访问，需要在数据库中授权：GRANT ALL ON your_db.* TO 'your_user'@'localhost' IDENTIFIED BY 'your_pass';
• 若提示"Can't connect to MySQL server"：尝试把DB_HOST从localhost改成127.0.0.1:3306（强制用TCP连接，避免socket路径问题）。

4. 检查WP-CLI配置文件是否覆盖了数据库设置 #

WP-CLI会读取wp-cli.yml或wp-cli.local.yml中的配置，可能覆盖了wp-config.php的数据库参数：

• 暂时重命名这些文件（比如mv wp-cli.yml wp-cli.yml.bak），然后执行WP-CLI命令测试。
• 如果恢复正常，打开配置文件删除或修正错误的dbuser、dbpass、dbhost等参数。

5. 确认wp-config.php的读取权限 #

虽然网站能访问说明Web用户有权限，但执行WP-CLI的用户（如SSH登录用户）可能没有读取权限：

• 执行ls -l wp-config.php查看文件权限和所有者，确保CLI用户有读权限（一般权限设为644即可）。

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