左侧导航栏图标不显示或显示为方块，大概率是FontAwesome字体未正确加载，需检查fontawesome-webfont.woff2是否404、Nginx/Apache是否配置了正确的font MIME类型及静态路径代理，并确认$cfg['PmaAbsoluteUri']以/结尾且与实际访问路径一致。
phpMyAdmin 左侧导航栏图标不显示或显示为方块？
大概率是图标字体（FontAwesome）未正确加载，或 CSS 路径被覆盖。phpMyAdmin 4.9+ 默认用 fontawesome-webfont.woff2 渲染数据库/表图标，但若部署在子路径、反向代理后，或自定义了 vendor/ 目录，@font-face 的 src 路径可能失效。
检查浏览器开发者工具的「Network」标签页，过滤 fontawesome，看是否返回 404；再看「Console」是否有 Failed to decode downloaded font 类报错。
- 确认
phpmyadmin/css/font-awesome/fonts/下存在fontawesome-webfont.woff2等文件（不是空目录） - 若用 Nginx，确保
location ~ \.(woff2?|eot|ttf|otf)$块允许静态文件访问，且未被deny all拦截 - 若通过 Apache alias 或子目录访问（如
/pma/），需在config.inc.php中显式设置：$cfg['PmaAbsoluteUri'] = 'https://example.com/pma/';
否则字体 CSS 中的相对路径会错位
点击数据库名不自动展开表列表？
这是默认行为变更：从 phpMyAdmin 5.0 开始，NavigationTreeEnableGrouping 默认为 true，且折叠逻辑改由前端 JS 控制，不再依赖服务端刷新。若点击无反应，通常不是配置错误，而是 JS 加载失败或冲突。
- 打开浏览器控制台，检查是否有
Uncaught ReferenceError: $ is not defined—— 表明 jQuery 未加载，可能是主题覆盖了js/vendor/jquery.min.js - 禁用所有浏览器插件（尤其广告/脚本拦截类），重试；再尝试用隐身窗口访问
- 检查
phpmyadmin/js/dist/navigation.js是否被成功加载（非 403/404），该文件负责绑定.database > a的 click 事件并切换.tables的display - 临时在
config.inc.php中加一行：$cfg['NavigationTreeEnableGrouping'] = false;
可退回到旧版分组逻辑（数据库 → 表两级平铺），验证是否为 grouping 机制导致
想自定义图标（比如用数据库类型区分 MySQL/MariaDB/PostgreSQL）？
phpMyAdmin 不提供开箱即用的数据库类型图标切换，但可通过覆盖 CSS 实现。它给每个数据库节点的 <li> 添加了 data-type 属性（值为 mysql、mariadb 等），可用属性选择器精准控制。
立即学习“PHP免费学习笔记（深入）”；
在 phpmyadmin/css/custom.css（需在 config.inc.php 中启用：
$cfg['CustomCSS'] = 'css/custom.css';）中添加：
/* 替换 MySQL 数据库图标 */
#serverinfo li[data-type="mysql"] > .icon {
background-image: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><circle cx="12" cy="12" r="10" fill="%234479a1"/></svg>');
}
/* 隐藏原 Font Awesome 图标文字 */
#serverinfo li[data-type="mysql"] > .icon::before { content: ""; }-
data-type值取决于服务器实际响应，可通过浏览器检查元素确认，常见值有：mysql、mariadb、postgresql（仅当启用了 pgsql 扩展） - 不要直接修改
phpmyadmin/css/common.css，升级时会被覆盖；必须走CustomCSS机制 - SVG URL 中的
%23是#的编码，避免 CSS 解析错误
展开状态无法记忆（刷新后全收起）？
phpMyAdmin 使用 localStorage 存储展开状态，键名为 pma_navigation_tree_state。如果每次刷新都重置，说明存储失败或被清除。
- 检查浏览器是否启用了「阻止第三方 Cookie 和网站数据」或「无痕模式」，这会导致 localStorage 不可用
- 在控制台执行
localStorage.getItem('pma_navigation_tree_state')，返回null即未写入；返回长字符串则说明已记录，此时问题在 JS 初始化阶段未能读取 - 确认
config.inc.php中未设置$cfg['NavigationTreeShowAll'] = true，该选项强制所有节点展开，会绕过状态保存逻辑 - 极少数情况是 PHP session 未正常启动（如
session.save_path不可写），导致前端获取不到用户偏好上下文，间接影响 JS 初始化
真正卡住的地方往往不在配置项本身，而在字体路径、JS 加载顺序、localStorage 权限这些边缘条件——它们不报错，但让所有「应该生效」的设置静默失效。
