Laravel无法连接cPanel MySQL数据库，部署配置失败求助

我之前在部署Laravel到cPanel环境时也碰到过一模一样的问题，结合cPanel的特性，给你几个实用的排查和解决方向：

1. 别默认用localhost，检查cPanel提供的实际数据库主机地址 #

很多cPanel主机的MySQL服务并不是绑定在localhost（尤其是使用云主机集群的服务商），你需要登录cPanel后台，找到MySQL Databases或者Database Wizard页面，里面会明确显示你的数据库服务器地址——通常是类似db123.yourhost.com这样的专属域名，而不是localhost。把这个地址替换到.env的DB_HOST字段里再试。

2. 清理Laravel的配置缓存，确保.env修改生效 #

Laravel会缓存配置文件来提升性能，有时候你修改了.env，但旧的缓存配置还在生效。通过SSH连接到你的服务器，在项目根目录运行这两个命令：

php artisan config:clear
php artisan cache:clear

如果你的主机用的是Apache或Nginx，也可以重启一下web服务器，确保配置完全刷新。另外要确认.env文件在项目根目录，且权限设置为644（避免服务器无法读取）。

3. 验证数据库用户的连接权限 #

虽然你给了用户全部权限，但要确认这个用户是否允许从当前服务器的IP连接。cPanel默认可能只允许localhost或服务器内部IP访问数据库：

• 登录cPanel，找到Remote MySQL选项，添加你的服务器公网IP（或者临时用%测试，注意生产环境不要这么做）；
• 手动用命令行测试连接，确认用户和地址没问题：

mysql -u myusername -p -h 你的DB_HOST地址 mydbname

输入密码后如果能成功登录，说明用户权限和地址是对的；如果登不上，回到cPanel重新检查用户的创建过程，确保用户名和密码完全匹配。

4. 确认MySQL端口是否正确 #

默认MySQL端口是3306，但部分主机商会修改这个端口。你可以在cPanel的数据库页面找到端口信息，或者直接咨询主机商。如果端口不是3306，更新.env里的DB_PORT字段即可。

5. 检查config/database.php是否覆盖了.env配置 #

有时候项目的config/database.php文件里会硬编码数据库配置，导致.env的设置不生效。打开这个文件，查看mysql配置段是否使用了env()函数读取变量：

'connections' => [
    'mysql' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST', 'localhost'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE', 'forge'),
        'username' => env('DB_USERNAME', 'forge'),
        'password' => env('DB_PASSWORD', ''),
        // ...其他配置
    ],
],

如果这里是写死的具体值，改成上面这种用env()的形式，这样才会优先读取.env的配置。

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