部署网站后提示'Access denied for user'数据库连接失败如何解决？

Failed to connect to MySQL: Access denied for user 'everjoe'@'localhost' (using password: YES)

该报错本质是MySQL服务端校验登录信息不通过，和本地XAMPP环境与服务器环境的配置差异有关，常见触发原因如下：

• 站点数据库配置文件未适配服务器环境：本地XAMPP的数据库账号密码和服务器MySQL的账号密码不一致，代码上传时没有修改对应配置项
• 服务器MySQL不存在everjoe用户：仅导入数据库备份数据不会同步本地创建的MySQL用户及权限配置，本地的everjoe用户默认不会在服务器端自动生成
• 用户未分配对应数据库的访问权限：即便服务器端创建了同名的everjoe用户，没有给该用户分配目标数据库的操作权限也会触发权限拒绝
• 主机登录限制：everjoe用户的允许登录主机被设置为非localhost的地址（比如127.0.0.1、特定外网IP），没有开放localhost的登录权限
• 密码匹配错误：配置文件里的密码存在大小写错误、特殊字符未转义，或是创建用户时输入的密码和配置文件填写的不一致

1. 核对站点数据库配置
   找到站点的数据库配置文件（常见命名为config.php、db.php、.env，不同框架路径不同），确认如下配置项和服务器实际参数完全匹配：

// 通用数据库配置示例
$db_host = 'localhost';
$db_name = '你的目标数据库名称';
$db_user = 'everjoe';
$db_password = '你设置的数据库密码';

2. 校验服务器MySQL用户是否存在
   登录服务器端的phpMyAdmin，进入「用户账户」页面，确认是否存在everjoe@localhost这个用户。如果不存在，手动创建该用户，密码和配置文件中填写的内容保持一致。
3. 分配数据库操作权限
   用户创建完成后，给该用户绑定目标数据库的操作权限：

• 在phpMyAdmin中选中你导入的目标数据库，进入「权限」标签页
• 找到everjoe@localhost用户，勾选站点所需的权限（常规站点需要SELECT/INSERT/UPDATE/DELETE/CREATE/ALTER等权限，测试阶段可以先勾选所有权限），点击「执行」保存配置

4. 测试连接有效性
   可以新建一个临时测试文件验证连接是否正常，代码如下：

<?php
$conn = mysqli_connect('localhost', 'everjoe', '你的数据库密码', '你的数据库名');
if (!$conn) {
    die("连接失败: " . mysqli_connect_error());
}
echo "数据库连接正常";
mysqli_close($conn);
?>

将文件上传到站点根目录访问，确认连接正常后立刻删除该测试文件，避免暴露敏感信息带来安全风险。
5. 异常场景排查
如果以上操作完成后仍然报错，检查MySQL配置是否开启了本地密码登录限制，或是everjoe用户的host字段设置有误，必要时可以先将host临时设置为%（允许所有地址登录，仅用于测试，生产环境不建议使用）验证是否为主机限制问题。

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