为何phpMyAdmin在某些主题下无法显示主键的金色钥匙图标？

phpMyAdmin主键钥匙图标不显示的根源是主题资源路径失效，具体因$cfg['ThemePath']配置错误、Web服务器拒绝访问themes/目录或themes/pmahomme/img/icn_pk.png文件缺失/权限不足，且浏览器可能缓存了404响应。

phpMyAdmin 主键钥匙图标不显示的根源是主题资源路径失效

金色钥匙图标（icn_pk.png 或类似文件）不是硬编码在 php 里，而是由当前激活的主题（如 pmahomme）通过 css 的 background-image 加载的。一旦 $cfg['themepath'] 配置错误、web 服务器拒绝访问 themes/ 目录，或对应主题子目录下缺失该图标文件，就会显示为空白、方块或 404 占位符。

检查 themes/pmahomme/img/ 下是否真实存在钥匙图标文件

phpMyAdmin 不会报错提示“图标缺失”，它只会静默加载失败。必须手动确认文件是否存在且可读：

• themes/pmahomme/img/icn_pk.png 是主键钥匙图标的默认路径（部分旧版用 icn_key.png）
• 用 SSH 进入 phpMyAdmin 安装目录，执行 ls -l themes/pmahomme/img/icn_pk.png 确认文件存在
• 若文件权限为 600 或属主非 Web 进程用户（如 www-data），需改为 644 并确保组/其他用户有读权限
• Docker 环境常见问题：挂载时遗漏 themes/ 目录，或镜像内该路径被覆盖为空目录

$cfg['ThemePath'] 配置错误会导致所有图标路径拼接失败

这个配置决定 phpMyAdmin 如何生成图标 URL。错误值会让浏览器请求类似 /phpmyadmin/themespmahomme/img/icn_pk.png（缺斜杠）或 /themes/pmahomme/...（路径越界）这类非法地址。

• 打开 config.inc.php，定位 $cfg['ThemePath'] —— 它**必须**是相对于 index.php 的相对路径，正确写法是 './themes'（开头带 ./）
• 常见错误：'themes'（无点斜杠）、'/themes'（绝对路径）、''（空字符串）或注释掉该行
• 同时检查 $cfg['ThemeDefault'] 是否为有效主题名，比如 'pmahomme'，末尾空格或拼写错误（如 'pmahome'）会导致整个主题加载失败，图标自然不出现
• 修改后需重启 Web 服务（Nginx/Apache）或清除 OPcache（若 opcache.revalidate_freq=0）

浏览器缓存了 404 响应导致图标长期不恢复

HTTP 规范允许缓存 404 响应（尤其当服务器返回了 Cache-Control: public）。即使你已修复路径和权限，浏览器仍可能持续显示旧的“图标缺失”状态。

• 在浏览器地址栏直接访问 /phpmyadmin/themes/pmahomme/img/icn_pk.png，看是否返回图片或 404
• 若返回 404，请回退检查前三个环节；若返回图片但页面仍不显示，说明是缓存问题
• 打开开发者工具 → Network → 勾选 Disable cache，然后强制刷新（Ctrl+Shift+R）
• 临时清除该域名下所有缓存（包括 Service Worker），或换隐身窗口测试

真正容易被忽略的是：**图标路径失效和浏览器缓存 404 是两个独立问题，必须分别验证、分别解决**。很多人修完配置就以为万事大吉，却卡在缓存这一步，反复怀疑配置没生效。