Laravel项目部署cPanel遇SQLSTATE[HY000][1044]数据库访问拒绝求助

这个错误的核心逻辑很清晰：你的MySQL用户amartuki_finance没有被授予访问目标数据库amartuki_finance的权限——这和你修改的.env或config/database.php配置文件关系不大（当然我们还是会确认配置细节）。下面是针对cPanel环境的分步解决方案：

1. 确认cPanel中数据库与用户的关联权限 #

这是最常见的触发原因，cPanel中创建数据库和用户后，必须手动完成「用户-数据库」的关联并分配权限：

• 登录你的cPanel面板，找到MySQL Databases功能入口
• 在Add User to Database区域，选中你的用户amartuki_finance和数据库amartuki_finance，点击Add
• 进入权限分配页面，调试阶段可以直接勾选ALL PRIVILEGES（生产环境建议按需分配），然后点击Make Changes保存设置

2. 清除Laravel配置缓存 #

Laravel会自动缓存配置文件，有时候你修改了.env但缓存没同步更新，导致程序仍在使用旧配置：

• 如果你的cPanel支持SSH终端，登录后进入项目根目录，执行以下命令：

  php artisan config:clear
  php artisan cache:clear
  

• 若没有SSH权限，可以临时在routes/web.php中添加一段路由代码，访问对应路径清除缓存：

  Route::get('/clear-cache', function() {
      Artisan::call('config:clear');
      Artisan::call('cache:clear');
      return "缓存已清除！";
  });
  

  访问你的域名/clear-cache完成操作后，记得删除这段代码。

3. 验证数据库主机地址是否正确 #

部分cPanel主机的数据库主机并非127.0.0.1，可能是localhost或特定域名（比如mysql.yourdomain.com）：

• 回到cPanel的MySQL Databases页面，查看Database Host字段的官方提示，将.env中的DB_HOST修改为对应地址。

4. 直接测试用户权限有效性 #

可以通过phpMyAdmin验证用户是否能正常访问数据库：

• 在cPanel中打开phpMyAdmin，切换到用户账户标签，找到amartuki_finance@localhost
• 点击编辑权限，确认该用户对amartuki_finance数据库拥有所需权限；或者直接用该用户登录phpMyAdmin，检查是否能看到并操作目标数据库。

额外排查细节 #

• 核对.env中的密码是否和cPanel设置完全一致，注意不要包含多余空格或未正确输入的特殊字符（.env中特殊字符无需转义，直接书写即可）
• 确认数据库amartuki_finance确实存在于你的cPanel主机中，没有拼写错误

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