你是否曾遇到这种场景：在 phpMyAdmin 中点击“导出”或“执行”按钮后，页面完全没有响应？打开开发者工具检查，控制台赫然显示 $ is not defined 错误。别担心，这通常意味着页面未能成功加载 jQuery——phpMyAdmin 依赖它来驱动交互逻辑，而主题目录下的 js/vendor/jquery/jquery.min.js 很可能没有被浏览器正确获取。
排查的第一步，请打开浏览器开发者工具（按 F12），切换到 Network 面板，刷新页面，并筛选关键词 jquery——重点观察 jquery.min.js 的返回状态码。如果返回 404 或 403，说明文件路径或权限有问题。接下来，确认你启用的主题目录（例如 themes/pmahomme/）下确实存在 js/vendor/jquery/jquery.min.js，并且该文件的权限是否允许 Web 进程（www-data 或 nginx 用户）读取。此外，许多 Nginx 或 Apache 的安全规则会默认拦截 .min.js 结尾的文件，建议检查 Web 日志中是否有类似 access denied to "/phpmyadmin/themes/xxx/js/vendor/jquery/jquery.min.js" 的记录。还有一个容易被忽略的小问题：某些脚本拦截插件（如 uBlock Origin、AdGuard）可能将远程 CDN 回退路径中的 jQuery 误判为广告资源并直接拦截，请尝试临时禁用这些插件。
按钮可见但点击后卡住，Network 中 export.php 返回 500 或空白
前端 JavaScript 已经发出了请求，但后端的 PHP 执行时崩溃了。这类问题通常与主题本身关系不大，但启用新主题后可能触发了某些未初始化的扩展逻辑——例如新主题调用了 mbstring 函数，而该扩展根本没有启用。排查时请重点查看 PHP 错误日志（不是 Nginx 日志），通常 export.php 会报告致命错误：最常见的是 Allowed memory size exhausted 或 Call to undefined function mb_strlen()。请确认 mbstring 和 zlib 扩展均已启用——主题的压缩与多字节字符串处理依赖它们。作为临时调试手段，可在 export.php 文件开头添加两行：ini_set('display_errors', '1'); error_reporting(E_ALL);，再次点击导出，观察是否输出明确的错误信息。另外，尝试关闭“压缩导出文件”选项再执行一次——如果 zlib 未启用，该选项会直接导致致命错误。
主题启用后“高级功能”提示重现，或关系表操作失败
部分主题（尤其是自定义或第三方主题）在初始化时会动态修改 $cfg 配置。如果它们覆盖了 pmadb、bookmarktable 等关键项，控制用户的功能就会失效——表现为“设置未完成”提示反复弹出，或者点击“关系视图”、“列注释”等按钮无效。请检查主题的 theme.php 或 setup.php（如果存在）是否重写了 $cfg['Servers'][$i] 数组，尤其是是否删除了 'pmadb' 或修改了表名前缀。对比启用主题前后的浏览器源码，搜索 pma_token 和 pmadb——如果后者消失或值为空，说明主题干扰了配置加载流程。建议先切换回默认主题 pmahomme，确认高级功能恢复正常；然后逐行注释新主题 theme.php 中疑似初始化的代码，逐步定位问题段落。
themes/ 目录权限错误导致 CSS/JS 404，间接引发按钮失效
主题的图标、样式、JavaScript 依赖全部通过 Web 服务器直接输出。如果 themes/ 目录或其子目录权限设置不正确，浏览器可能连 theme.css 和 common.js 都无法加载，导致整个 UI 逻辑断开——虽然按钮在页面上渲染出来了，但绑定事件的 JavaScript 根本没有执行。因此，themes/ 目录及其所有子目录必须对 Web 进程具有可读和可执行权限（至少 755，不能设为 750 或 700）。属主应设置为 www-data:www-data（Debian/Ubuntu）或 nginx:nginx（CentOS/RHEL），不应为 root。如果 SELinux 处于启用状态，运行 ls -Z themes/ 确认上下文为 httpd_sys_content_t（Apache）或 httpd_sys_rw_content_t（需要写入临时文件时）；否则用 chcon -R -t httpd_sys_content_t themes/ 修复。另外，检查 $cfg['ThemePath'] 是否以 ./ 开头（例如 ./themes），若写成绝对路径或 URL 会导致所有资源请求返回 404。
归根结底，主题并非仅仅是更换皮肤——它参与了初始化流程、注入脚本，甚至可能改写配置。按钮失灵，往往不是“主题损坏”，而是它暴露了底层环境中早已存在的权限、扩展或路径问题。排查时不要只盯着主题文件夹，而是先聚焦 Network 中哪些资源返回 404、哪个 PHP 请求返回 500——这些才是真正的线索。
