new mysqli()连接数据库时出现“Access denied for user”错误怎么办？

Question

在使用new mysqli()连接数据库时，如果遇到“Access denied for user”错误，通常是因为用户名、密码或主机配置不正确。首先确认数据库用户名和密码无误，检查是否在正确的数据库服务器上进行连接。其次，确保该用户有权限从当前IP地址访问数据库，可能需要在数据库中用GRANT命令赋予相应权限。另外，注意连接字符串中的主机参数，localhost和127.0.0.1虽然通常等效，但在某些配置下可能会导致不同结果。如果使用了非默认端口，也需要明确指定。最后，查看MySQL错误日志获取更多细节，排查是否存在其他安全设置干扰，例如SSL要求或插件认证方式不匹配等问题。通过这些步骤，基本可以解决“Access denied for user”错误。

Answer 1

1. 初步诊断：确认基础配置

当使用 new mysqli() 连接数据库时，如果遇到“Access denied for user”错误，首先需要检查以下几点：

1. 用户名和密码是否正确： 确保提供的用户名和密码与数据库中配置的一致。
2. 数据库服务器地址： 检查连接字符串中的主机参数（如 localhost 或 127.0.0.1）是否指向正确的数据库服务器。
3. 端口设置： 如果数据库运行在非默认端口（3306），需在连接字符串中明确指定端口号。

例如，一个基本的连接代码可能如下所示：

$mysqli = new mysqli("127.0.0.1", "username", "password", "database", 3306);

2. 权限排查：确保用户权限匹配

即使用户名和密码无误，仍可能出现访问拒绝问题。这通常是因为用户没有从当前IP地址访问数据库的权限。以下是解决步骤：

• 登录到MySQL数据库，执行以下命令检查用户的权限范围：
  SHOW GRANTS FOR 'username'@'host';
• 如果发现权限不足，可以通过 GRANT 命令赋予相应权限。例如：
  GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' IDENTIFIED BY 'password';
• 刷新权限以使更改生效：
  FLUSH PRIVILEGES;

注意：这里的 '%' 表示允许从任意IP地址访问，具体可以根据实际需求调整为特定IP或子网。

3. 主机参数分析：localhost vs 127.0.0.1

虽然 localhost 和 127.0.0.1 通常等效，但在某些配置下可能导致不同结果。原因包括：

参数	特点
localhost	通常通过Unix套接字连接，而非TCP/IP。
127.0.0.1	强制通过TCP/IP协议连接。

如果遇到连接问题，可以尝试将 localhost 替换为 127.0.0.1，或者检查服务器是否启用了Unix套接字支持。

4. 高级排查：日志与安全设置

如果上述方法仍无法解决问题，可以进一步通过以下方式深入排查：

• 查看MySQL错误日志： 错误日志通常位于 /var/log/mysql/error.log，可以帮助定位具体问题。
• SSL要求： 某些情况下，数据库可能要求使用SSL连接。如果未启用SSL，可能会导致访问拒绝。
• 认证插件不匹配： MySQL 8.0 默认使用 caching_sha2_password 插件，而旧版客户端可能不支持。可以通过以下命令修改用户认证插件：
  ALTER USER 'username'@'host' IDENTIFIED WITH mysql_native_password BY 'password';

此外，可以绘制流程图帮助理解排查步骤：

graph TD;
            A[开始] --> B{用户名/密码正确?};
            B --是--> C{权限匹配?};
            C --否--> D[赋予权限];
            C --是--> E{主机参数正确?};
            E --否--> F[调整为主机IP];
            E --是--> G{其他安全设置?};
            G --是--> H[检查SSL/插件];
            G --否--> I[成功];