如何修复phpMyAdmin 5.2.0链接不可点击、JS报错问题

故障表现 #

• 部署版本为phpMyAdmin 5.2.0，所有菜单、数据库、数据表关联链接均无法点击，全功能不可用
• 浏览器控制台存在JavaScript执行错误
• 故障界面截图：
  

控制台报错信息 #

Uncaught ReferenceError: Messages is not defined
    at new MenuResizer (menu_resizer.js?v=5.2.0:43:13)
    at HTMLUListElement.<anonymous> (menu_resizer.js?v=5.2.0:168:37)
    at Function.each (jquery.min.js?v=5.2.0:2:3003)
    at obj.<computed>.each (jquery.min.js?v=5.2.0:2:1481)
    at obj.<computed>.init (menu_resizer.js?v=5.2.0:164:19)
    at $.fn.menuResizer (menu_resizer.js?v=5.2.0:203:27)
    at HTMLDocument.<anonymous> (functions.js?v=5.2.0:3619:17)
    at e (jquery.min.js?v=5.2.0:2:30038)
    at t (jquery.min.js?v=5.2.0:2:30340)

触发背景 #

• 初始部署环境为Ubuntu 20.04 + Nginx，首次安装的低版本phpMyAdmin存在样式显示异常
• 手动执行升级操作到5.2.0版本后立即触发该故障

故障根因 #

报错核心是全局Messages变量未定义，属于升级过程中新旧版本静态文件冲突、服务端静态缓存未清理、文件权限不足导致核心JS资源未正常加载，前端JS执行链直接中断，所有绑定在DOM上的点击事件未完成初始化，最终导致所有链接无法点击。

修复步骤 #

• 清理phpMyAdmin本地缓存
  进入phpMyAdmin实际部署目录（Nginx环境默认路径通常为/usr/share/nginx/html/phpmyadmin或/var/www/html/phpmyadmin，按自身实际部署路径调整），执行以下命令删除旧缓存文件：

rm -rf tmp/*
rm -rf js/cache/*
rm -rf css/cache/*

• 修正目录权限
  确保Nginx运行用户（默认www-data）对phpMyAdmin所有文件有读取权限，执行以下命令（注意替换路径为自身实际部署路径）：

chown -R www-data:www-data /your/phpmyadmin/deploy/path
find /your/phpmyadmin/deploy/path -type d -exec chmod 755 {} \;
find /your/phpmyadmin/deploy/path -type f -exec chmod 644 {} \;

• 检查Nginx配置规则
  打开phpMyAdmin对应的Nginx站点配置文件，排查是否存在错误拦截静态资源的规则：

重点排查两类错误配置：一是直接拦截.js/.css后缀文件访问的拒绝规则；二是PHP解析规则未覆盖phpMyAdmin目录，导致核心动态资源请求返回403/404。
配置修改完成后执行nginx -t验证语法无误，重载Nginx服务：systemctl reload nginx

• 清理浏览器缓存
  在故障页面按Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）执行无缓存强制刷新；如果仍不生效，清空浏览器对应站点的Cookie、本地存储后重新访问。
• 极端场景修复
  如果以上操作均无效，说明升级过程中存在文件缺失：
  • 先备份目录下的config.inc.php配置文件到其他位置
  • 从phpMyAdmin官方渠道获取5.2.0版本完整安装包，覆盖部署目录下所有文件
  • 把备份的config.inc.php放回部署目录，重新执行上述缓存清理、权限修正操作

验证标准 #

修复完成后访问phpMyAdmin，浏览器控制台无Messages is not defined报错，所有菜单、库表链接可正常点击跳转。

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