无法连接本地数据库：Drupal 8升级时连接Drupal 7数据库遭拒绝

我来帮你排查这个棘手的数据库连接问题——毕竟你已经确认数据库正常运行、自己能访问，却还是遇到SQLSTATE[HY000] [2002]拒绝连接的错误，咱们从几个容易忽略的细节入手：

1. 强制用TCP/IP方式连接数据库 #

很多人习惯在settings.php里写host' => 'localhost'，但PHP的MySQL扩展有时候会优先尝试socket文件连接，而非TCP/IP。你可以试试把主机地址换成127.0.0.1强制走TCP连接，同时确认端口号和你的MySQL服务一致：

$databases = array (
  'default' => array (
    'default' => array (
      'database' => '你的D7数据库名',
      'username' => '数据库用户名',
      'password' => '数据库密码',
      'host' => '127.0.0.1', // 替换原有的localhost
      'port' => '3306', // 若你的MySQL改了端口，对应修改
      'driver' => 'mysql',
      'prefix' => '',
    ),
  ),
);

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

虽然你能正常访问数据库，但要确认当前使用的数据库用户是否允许从Drupal所在的服务器（本地环境就是127.0.0.1）连接。登录MySQL执行以下命令检查：

SELECT user, host FROM mysql.user WHERE user='你的数据库用户名';

如果结果里没有你的用户名@127.0.0.1或你的用户名@localhost，就需要给用户授权：

GRANT ALL PRIVILEGES ON 你的D7数据库名.* TO '你的用户名'@'127.0.0.1' IDENTIFIED BY '你的密码';
FLUSH PRIVILEGES;

3. 排查防火墙/安全软件的拦截 #

本地防火墙、杀毒软件或者安全工具可能会悄悄拦截PHP和MySQL之间的连接，哪怕MySQL处于运行状态。你可以临时关闭这些软件，再尝试升级操作；如果连接恢复正常，记得给PHP或MySQL添加允许通信的规则。

4. 确认PHP的MySQL扩展状态 #

Drupal 8推荐使用mysqli扩展而非旧的mysql扩展，你需要确保PHP环境已经加载了这个扩展：

• 创建一个phpinfo.php文件，内容为：

<?php phpinfo(); ?>

• 访问这个文件，搜索mysqli关键词，确认扩展已正常加载。如果没有，需要在PHP配置里启用它。

5. 用基础脚本测试连接（排除Drupal本身问题） #

写一个简单的PHP脚本，直接测试数据库连接，看看是不是Drupal的配置问题：

<?php
$conn = mysqli_connect('127.0.0.1', '你的用户名', '你的密码', '你的D7数据库名');
if (!$conn) {
  die("连接失败: " . mysqli_connect_error());
}
echo "数据库连接成功！";
mysqli_close($conn);
?>

如果这个脚本也报错，说明问题出在PHP和MySQL的底层连接上，和Drupal无关；如果能成功连接，那就要再仔细检查settings.php里的其他配置（比如数据库前缀、驱动名称是否写错）。

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