cPanel通过Installatron安装Magento时出现数据库查询失败错误

用户报错信息如下：

数据库查询失败。您输入的数据库信息是否正确？账户是否有可用磁盘空间？
技术信息：
method = query
arguments = array ( 0 => 'SELECT user_id FROM mg_admin_user WHERE is_active='1' ORDER BY user_id ASC LIMIT 1', 1 => NULL, 2 => 'user_id',)

排查解决步骤 #

• 校验数据库账号权限：进入cPanel「MySQL数据库」管理页，确认你填写的数据库用户已绑定目标Magento数据库，且拥有全部操作权限，勾选所有权限选项后保存即可。
• 排查表结构初始化异常：登录cPanel自带的phpMyAdmin，打开目标数据库检查是否存在mg_admin_user表。如果表不存在说明安装过程中表结构创建失败，先手动清空该数据库的所有残留数据，再重新发起安装。
• 检查资源配额：确认cPanel账户剩余磁盘空间充足，同时检查对应数据库的存储配额未达到上限，部分主机商限制了单数据库的最大存储容量，配额不足会导致数据写入、表创建失败。
• 清理Installatron残留配置：进入cPanel的Installatron应用安装器，在「我的应用」列表删除所有安装失败的Magento残留记录，避免异常缓存干扰新安装流程。
• 校验版本兼容性：确认当前cPanel搭载的MySQL/MariaDB版本符合待安装Magento的版本要求，例如Magento 2.4.x系列要求MySQL 8.0或MariaDB 10.4及以上版本，版本不兼容会触发表结构创建、查询异常。

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