如何解决phpMyAdmin提示缺少配置存储的问题？-phpMyAdmin-PHP中文网

答案是phpmyadmin“配置存储未完全配置”提示反复出现，根本原因是缺少可写的phpmyadmin库及15张控制表，且controluser权限、认证方式、配置项三者必须全部正确；需手动建库、授权、导入表、配置controluser并适配mysql 8+认证插件。

这个问题不是配置写错了，而是 phpmyadmin 缺少一个可写的后台数据库——phpmyadmin 库及其 15 张控制表。不建库、不导入表、不配专用 controluser，光改 config.inc.php 永远无效。

为什么“配置存储未完全配置”会反复出现

phpMyAdmin 的“保存查询”“列偏好设置”“关系视图”等功能，全依赖 phpmyadmin 数据库里的表（如 pma_history、pma_column_info 等）。只要以下任一条件不满足，提示就会持续弹出：

phpmyadmin 数据库不存在，或存在但为空
controluser（比如 pma）没有对这个库的 SELECT/INSERT/UPDATE/DELETE 权限
config.inc.php 中的 $cfg['Servers'][$i]['controluser'] 和 controlpass 指向了错误用户或密码
MySQL 8+ 默认使用 caching_sha2_password 插件，而旧版 phpMyAdmin 的 controluser 不兼容该认证方式

手动创建 phpmyadmin 库和 controluser

别用 phpMyAdmin 自己操作——此时它可能根本进不去。直接用 MySQL 命令行（root 权限）执行：

CREATE DATABASE IF NOT EXISTS `phpmyadmin`;
GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma'@'localhost' IDENTIFIED BY 'your_strong_password';
FLUSH PRIVILEGES;

然后导入表结构：

Debian/Ubuntu：sudo mysql -u root -p phpmyadmin
CentOS/RHEL：路径通常是 /usr/share/doc/phpMyAdmin-*/examples/create_tables.sql，需确认版本号
手动下载：从 phpMyAdmin 官网对应版本的 sql/create_tables.sql 文件

注意：如果 MySQL 绑定的是 Unix socket（非 TCP），controlhost 可设为空字符串 ''，但要确保 mysql.sock 路径在 my.cnf 中一致。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

配置 config.inc.php 的关键项

编辑 config.inc.php（通常在 /etc/phpmyadmin/ 或 phpMyAdmin 根目录），确保这几行存在且未被注释（$i 一般是 1）：

$cfg['Servers'][$i]['controlhost'] = 'localhost';
$cfg['Servers'][$i]['controluser'] = 'pma';
$cfg['Servers'][$i]['controlpass'] = 'your_strong_password';

必须用专用用户（如 pma），不要用 root；密码含特殊字符（如 @、$）时，需在 PHP 字符串中正确转义（例如 'p@ss$word' → 'p@ss\$word'）；MySQL 8+ 用户需额外执行：ALTER USER 'pma'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_strong_password';，否则连接失败。

验证与常见卡点

做完以上步骤后，清空浏览器缓存和 Cookie，重新登录。若仍报错，重点排查：

controluser 是否真能连上 MySQL：运行 mysql -u pma -p -h localhost phpmyadmin 测试
导入的表是否完整：登录 MySQL 后执行 USE phpmyadmin; SHOW TABLES;，应返回 15 行
PHP 是否启用了 mysqli 扩展：运行 php -m | grep mysqli，没输出就得启用 extension=mysqli 并重启 Web 服务
Apache/Nginx 是否允许访问 phpMyAdmin 目录：检查 Require local 是否被误设为 Require all denied