如何排查 connect() 函数遇到 “Access Denied” 错误的问题？

M66 2025-07-18

在 PHP 中使用 connect() 函数连接数据库时，遇到 “Access Denied” 错误是一个比较常见的问题。这个错误一般表明连接数据库的权限不被允许，导致连接失败。本文将详细介绍排查这类问题的思路和具体方法，帮助你快速定位并解决问题。

一、理解 “Access Denied” 错误的含义

“Access Denied” 通常是数据库服务器拒绝连接请求，原因可能是：

用户名或密码错误
连接的主机不被允许访问数据库
数据库用户权限不足
数据库服务器配置限制

这类问题常见于 MySQL 等关系型数据库。

二、排查步骤详解

1. 检查用户名和密码是否正确

在 PHP 代码中，连接数据库的代码类似如下：

<?php
$servername = "m66.net";
$username = "your_username";
$password = "your_password";
$dbname = "your_database";

// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);

// 检查连接
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
?>

确认 $username 和 $password 是否正确。错误的用户名或密码会导致“Access Denied”。

2. 确认连接的主机是否有权限

MySQL 用户权限是基于用户名和主机的组合，例如 user@localhost 和 user@192.168.1.1 是不同的账户。

如果你用 IP 地址或远程主机连接，确认数据库用户有对应主机的访问权限：

SELECT user, host FROM mysql.user WHERE user='your_username';

如果权限不足，可以使用如下命令添加权限：

GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'your_client_ip' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;

3. 检查数据库服务器是否开启远程连接

默认情况下，MySQL 服务器只允许本地连接。你需要确认 mysqld 的配置文件中 bind-address 设置是否允许远程访问。

通常配置文件 /etc/mysql/my.cnf 中：

bind-address = 0.0.0.0

表示允许所有 IP 连接。如果是 127.0.0.1，则仅限本机连接。

4. 检查防火墙设置

防火墙可能阻止了数据库端口（通常是 3306）对外开放，导致无法连接。可以尝试使用命令检测端口连通性：

telnet m66.net 3306

如果连接失败，请检查防火墙设置。

5. 使用 PHP 错误信息辅助定位

连接失败时，mysqli_connect_error() 可以给出具体的错误提示：

<?php
$conn = new mysqli("m66.net", "your_username", "your_password", "your_database");
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
?>

结合错误提示，有针对性地进行排查。

三、总结

当你在 PHP 使用 connect() 函数遇到 “Access Denied” 错误时，应该从以下几个方面依次排查：

确认用户名和密码是否正确
确认数据库用户是否有对应主机的访问权限
检查数据库服务器的远程访问配置
检查网络和防火墙设置
利用错误提示信息辅助定位

通过以上步骤，基本可以找到并解决连接被拒绝的问题。

connect