Laravel应用创建用户自定义数据库时的权限拒绝问题排查

你的核心问题很明确：服务器上的数据库用户缺少全局创建数据库的权限。本地环境你大概率用的是root账号（默认拥有全权限），但服务器上通过WHM/cPanel创建的数据库账号，默认只拥有对指定已有数据库的操作权限，并没有CREATE DATABASE的全局权限，所以直接用Laravel执行创建语句会被拒绝。下面是针对性的解决方案和建议：

1. 先确认用户的权限情况 #

如果服务器有MySQL root权限，登录MySQL终端执行以下命令，查看目标用户的权限详情：

SHOW GRANTS FOR '你的数据库用户名'@'你的主机地址';

注意：主机地址可能是localhost、服务器公网IP，或者%（允许所有主机），必须和Laravel配置里的host字段完全对应。
如果结果中没有CREATE ON *.*的条目，就可以确认用户确实缺少创建数据库的权限。

2. 授予全局创建数据库权限（适用于VPS/独立服务器） #

如果你拥有服务器的root权限，直接给目标用户添加权限即可：

-- 授予创建数据库的全局权限
GRANT CREATE ON *.* TO '你的数据库用户名'@'你的主机地址';
-- 刷新权限使设置立即生效
FLUSH PRIVILEGES;

执行完成后再测试Laravel的创建代码，应该就能正常运行了。

3. cPanel/WHM环境下的安全替代方案（无root权限时） #

如果是共享主机或只能通过cPanel/WHM管理数据库，不建议直接修改MySQL权限（可能违反主机规则），可以改用cPanel的UAPI接口来创建数据库：
你可以在Laravel里通过HTTP请求调用该接口，示例代码如下（需要先安装Guzzle）：

$client = new \GuzzleHttp\Client();
$response = $client->request('POST', 'https://你的cPanel域名:2083/execute/Mysql/create_database', [
    'auth' => ['你的cPanel用户名', '你的cPanel密码'],
    'form_params' => [
        'name' => 'db_name' // 要创建的数据库名称
    ]
]);

提示：cPanel API的默认HTTPS端口是2083，WHM则是2087，具体可参考主机商的文档。

4. 额外的排查与安全建议 #

• 手动验证权限：在服务器上用目标用户登录MySQL，手动执行CREATE DATABASE test_db;，如果报错和Laravel一致，就能100%确认是权限问题。
• 查看MySQL错误日志：服务器上的MySQL错误日志（通常在/var/log/mysql/error.log或cPanel日志面板中）会给出更详细的拒绝原因，比如主机地址不匹配、权限范围不足等。
• 遵循最小权限原则：如果不是必须让数据库用户拥有创建权限，优先用cPanel/WHM API的方式操作，避免给用户过高权限，提升应用安全性。

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