phpMyAdmin 5.2.x 在 PHP 8.2+ 下因使用 string 等保留字导致 ParseError，无法解析启动，故删文件重装 5.2.x 无效；必须升级至 5.3.0+ 或降级至 5.1.2 等兼容版本。
phpMyAdmin 5.2升级失败后，为什么不能直接删文件重装？
因为 phpmyadmin 5.2.x 本身在 php 8.2+ 环境下存在 parseerror: syntax error, unexpected token "string" —— 它把 string 当作变量名用，而 php 8.2 把 string 列为保留字，连解析都失败。你看到的“升级失败”，大概率是升级后压根打不开登录页，或 nginx 返回 500，不是配置问题，是代码层面不兼容。
所以回滚不是“退回旧版”，而是退到一个能跑起来的版本：5.2.x 不行，就得切到 5.3.0 或更高；如果手头只有 5.2.1，那它就是无效版本，必须换。
确认当前 phpMyAdmin 版本并判断是否真需回滚
别凭感觉，先查真实版本：
- 执行
cat /www/server/phpmyadmin/VERSION（宝塔）或打开该目录下的VERSION文件 - 若显示
5.2.0、5.2.1或5.2.3，且你用的是 PHP 8.2/8.3，那就不用折腾回滚——这些版本天生不支持 - 若显示
5.1.2或更低，且升级后出错，才属于真正意义上的“升级失败”，需要还原
注意：phpMyAdmin 没有“降级安装包”，所谓回滚，本质是卸载当前无效版本 + 安装一个已知兼容的旧版（如 5.1.2）或新版（5.3.0+）。
手动回滚到 5.1.2（仅适用于 PHP 7.4–8.1）
如果你确定要退回旧稳定版（比如 PHP 8.1 环境），操作必须干净：
- 停服务：
systemctl stop nginx && systemctl stop php-fpm（或按宝塔实际服务名） - 删旧目录：
rm -rf /www/server/phpmyadmin（保留/www/server/phpmyadmin/config.inc.php备份好再删） - 下载兼容包：
wget https://files.phpmyadmin.net/phpMyAdmin/5.1.2/phpMyAdmin-5.1.2-all-languages.tar.gz - 解压重命名：
tar -xzf phpMyAdmin-5.1.2-all-languages.tar.gz && mv phpMyAdmin-5.1.2-all-languages phpmyadmin - 恢复配置：
cp /backup/config.inc.php /www/server/phpmyadmin/config.inc.php（路径按你备份位置改） - 检查扩展：
php -m | grep -E "mysqli|mbstring|openssl"，缺哪个就去宝塔 PHP 设置里启用
重启服务后仍白屏？重点检查 $cfg['blowfish_secret'] 是否为空，以及 $cfg['Servers'][$i]['auth_type'] 是否设为 'cookie' —— 新版默认更严格，旧版反而对配置容错高。
更推荐的“回滚”：跳过 5.2，直上 5.3.0+
PHP 8.2/8.3 用户强行退回 5.1.x 是权宜之计，长期看不如一步到位：
- 下载 5.3.0：
wget https://files.phpmyadmin.net/phpMyAdmin/5.3.0/phpMyAdmin-5.3.0-all-languages.tar.gz - 解压覆盖：
tar -xzf phpMyAdmin-5.3.0-all-languages.tar.gz && rm -rf /www/server/phpmyadmin && mv phpMyAdmin-5.3.0-all-languages /www/server/phpmyadmin - 复用原
config.inc.php即可，5.3.0 兼容大部分 5.2 配置项 - 关键验证点：
mysqli扩展必须启用，session.save_path目录要有写权限，否则登录页卡住不动
最容易被忽略的是：config.inc.php 里如果还留着 $cfg['Servers'][$i]['extension'] = 'mysql';，必须改成 'mysqli'，否则报 mysqli_real_escape_string(): Argument #1 ($mysql) must be of type mysqli, null given —— 这个错不提示具体哪行，只在 PHP 错误日志里出现。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
