控制用户连接失败的典型表现是登录时提示“无法连接控制用户”或“pma user not found”，但普通SQL操作正常，根源在于phpMyAdmin高级功能依赖的controluser账户未正确配置：用户名不存在、密码不匹配、Host不匹配（如localhost与127.0.0.1）、权限不足、phpmyadmin库缺失或表结构不全（如缺pma_history等），且需确保mysqli扩展启用、SELinux未拦截。
控制用户连接失败的典型表现
页面登录时提示“无法连接控制用户”或“pma user not found”，但普通数据库操作（如执行 sql）仍正常，说明问题出在 phpmyadmin 的高级功能依赖层——不是 mysql 本身连不上，而是它用来存 bookmark、history、designer_coords 等元数据的内部账户没打通。
$cfg['Servers'][$i]['controluser'] 配置错误
这个配置项必须指向一个真实存在、且具备特定权限的 MySQL 用户。常见错误包括：
-
controluser值写成不存在的用户名（比如'pma'），但 MySQL 中根本没创建该用户 -
controlpass与实际密码不一致，尤其注意大小写、特殊字符是否被 PHP 配置自动转义 - 把
controluser设为'root'，但 root 的Host是'localhost'，而 phpMyAdmin 实际通过 Unix socket 或 TCP 连接时 Host 匹配失败（例如用127.0.0.1连接时，'localhost'不等价） - 配置文件里用了
$cfg['Servers'][$i]['auth_type'] = 'config'，但没填controluser和controlpass，导致跳过认证直接连失败
controluser 权限不足或表结构缺失
即使用户名密码正确，如果缺少权限或元数据表没建好，照样报错。关键检查点：
- 确认
pmadb数据库（默认名'phpmyadmin'）已存在，且controluser对其有SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER全部权限 - 执行
SELECT User,Host FROM mysql.user WHERE User = 'pma';，确保返回结果中 Host 至少包含'localhost'或'127.0.0.1'（取决于你的连接方式） - 导入
create_tables.sql后，检查phpmyadmin库下是否真有pma_bookmark、pma_relation等表；漏掉任意一张，都会让 control user 功能失效 - 若用宝塔面板，注意其自动生成的
phpmyadmin库可能路径在/www/server/phpmyadmin/sql/下，别误用旧版脚本
PHP 扩展或 SELinux 干扰连接
这类问题不报 MySQL 错误，但会让 control user 认证静默失败：
- 确认
mysqli或pdo_mysql扩展已启用（php -m | grep mysql），control user 必须走 mysqli 连接，不支持 mysql 扩展（已废弃） - SELinux 启用时（CentOS/RHEL 默认），可能阻止 Apache/Nginx 进程访问 MySQL socket 文件，报错类似
Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock'；临时关闭测试：setenforce 0 - 某些 PHP 版本（如 8.2+）对空密码或弱密码校验更严格，
controlpass为空字符串会导致连接拒绝，必须显式设为''而非留空
pma_history 表，整个 control 功能就瘫痪，但错误日志往往只字不提具体缺哪张表。 
