PHP 代码在连接 MySQL 时出现“访问被拒绝”的问题，通常与以下几个方面有关：用户权限配置、连接参数设置、MySQL 服务状态等。以下是详细原因分析和修复方法：

---

1. 问题现象

通常会看到类似以下错误消息：

Warning: mysqli_connect(): (HY000/1045): Access denied for user 'username'@'hostname' (using password: YES/NO)

• username：尝试登录的 MySQL 用户名。
• hostname：用户尝试连接的主机名。
• using password: YES/NO：是否使用了密码。

---

2. 常见原因及修复方法

（1）用户名或密码错误

• 原因：PHP 使用的用户名或密码不正确。
• 修复：

1. 确认数据库用户是否存在：
   sql SELECT user, host FROM mysql.user;
2. 检查是否为该用户设置了正确的密码：
   sql ALTER USER 'username'@'hostname' IDENTIFIED BY 'correct_password';
3. 确认 PHP 中的连接代码是否正确： <?php $servername = "localhost"; $username = "username"; $password = "correct_password"; $dbname = "database_name"; $conn = new mysqli($servername, $username, $password, $dbname); if ($conn->connect_error) { die("Connection failed: " . $conn->connect_error); } echo "Connected successfully"; ?>

---

（2）用户没有权限连接

• 原因：数据库用户的权限不允许从指定主机连接。
• 修复：

1. 查看用户权限：
   sql SHOW GRANTS FOR 'username'@'hostname';
2. 如果权限不足，授予必要权限：
   sql GRANT ALL PRIVILEGES ON database_name.* TO 'username'@'hostname'; FLUSH PRIVILEGES;
3. 如果用户需要远程访问，确保使用了正确的主机名 %：
   sql CREATE USER 'username'@'%' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON *.* TO 'username'@'%'; FLUSH PRIVILEGES;

---

（3）主机名设置错误

• 原因：PHP 中的 $servername 值与 MySQL 配置不匹配。
• 修复：

1. 确认 MySQL 服务运行的主机名：
   • 本地连接：使用 localhost 或 127.0.0.1。
   • 远程连接：使用 MySQL 服务器的 IP 地址或主机名。
2. 修改 PHP 代码：
   php $servername = "127.0.0.1"; // 本地连接
3. 如果使用 UNIX 套接字连接，确保正确设置套接字路径：
   php $servername = "localhost"; $socket = "/var/run/mysqld/mysqld.sock"; // 套接字路径 $conn = new mysqli($servername, $username, $password, $dbname, null, $socket);

---

（4）MySQL 服务未启动

• 原因：MySQL 服务未运行或网络端口被阻止。
• 修复：

1. 检查 MySQL 服务状态：
   bash systemctl status mysql
   或
   bash service mysql status
2. 启动 MySQL 服务：
   bash sudo systemctl start mysql
3. 确认 MySQL 正在监听正确的端口（默认是 3306）：
   bash netstat -tln | grep 3306

---

（5）防火墙阻止连接

• 原因：防火墙或网络策略阻止了 MySQL 的远程访问。
• 修复：

1. 在 MySQL 服务器上，确保 3306 端口开放：
   bash sudo ufw allow 3306
2. 如果使用 AWS、阿里云等云服务，检查安全组规则，确保允许入站 TCP 3306。
3. 测试连接：
   bash telnet server_ip 3306

---

（6）MySQL 配置文件问题

• 原因：MySQL 配置文件 my.cnf 限制了用户连接。
• 修复：

1. 编辑 MySQL 配置文件：
   bash sudo nano /etc/mysql/my.cnf
   或
   bash sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
2. 确保 [mysqld] 部分没有以下限制：
   ini bind-address = 127.0.0.1
   如果需要远程连接，可以设置为：
   ini bind-address = 0.0.0.0
3. 重启 MySQL 服务：
   bash sudo systemctl restart mysql

---

（7）PHP 扩展未安装或配置错误

• 原因：PHP 缺少 MySQL 扩展或配置错误。
• 修复：

1. 检查是否安装了 MySQL 扩展：
   bash php -m | grep mysqli
2. 如果未安装，安装 mysqli 或 pdo_mysql 扩展：
   bash sudo apt install php-mysqli sudo systemctl restart apache2
3. 在 PHP 中启用扩展：
   编辑 php.ini 文件，确保以下行未被注释：
   ini extension=mysqli

---

3. 检查并验证连接

（1）使用 CLI 测试连接

• 在命令行中测试数据库连接是否正常：

  mysql -u username -p -h hostname -P 3306

（2）在 PHP 中测试连接

创建一个简单的测试文件 test_connection.php：

<?php
$servername = "localhost";
$username = "username";
$password = "password";

$conn = new mysqli($servername, $username, $password);

if ($conn->connect_error) {
    die("Connection failed: " . $conn->connect_error);
}
echo "Connected successfully";
?>

运行此脚本，确认是否成功连接。

---

4. 总结

• 逐步排查：从用户名、密码、主机名到 MySQL 服务状态，逐一检查。
• 注意权限：确保用户具有正确的权限。
• 检查网络：防火墙和端口配置是否正确。
• 优化配置：确保 MySQL 和 PHP 的配置文件匹配。

以上为关于解决PHP 代码在连接 MySQL 时出现“访问被拒绝”的详细介绍，更多信息请关注其他相关文章！