浏览器硬刷新无效因phpMyAdmin主题CSS通过index.php?route=动态加载且无有效缓存头，需在Nginx层重写路由至真实静态路径，并配置add_header Cache-Control与alias正确指向容器内/themes/目录。
直接清浏览器缓存或硬刷新往往无效——因为 phpMyAdmin 的主题 CSS 是通过 index.php?route= 动态加载的，URL 无变化，强缓存头又没生效，浏览器根本不会重新请求新内容。
为什么 Ctrl+F5 也刷不出新主题样式？
phpMyAdmin 默认不给主题资源（如 /themes/metro/css/theme.css）设置 Cache-Control 头，且前端常走 index.php?route=/theme/css/theme.css 这类带查询参数的路径。这类 URL 即使文件已更新，浏览器仍可能复用旧缓存，尤其当服务端返回了 304 或未设 immutable 时。
- 硬刷新（
Ctrl+F5）只强制重载 HTML 和主资源，对已缓存的 CSS/JS 文件未必触发完整重验证 - 开发者工具 Network 面板里能看到 CSS 请求状态是
from memory cache或304，说明根本没拉新内容 - 如果 Nginx/Apache 没配
location ^~ /themes/+add_header Cache-Control，那所有主题静态资源都默认“不缓存但也不强制刷新”
必须在 Nginx 中拦截并重写 theme 动态请求
不能依赖 PHP 输出头，得在 Web 服务器层把 index.php?route=/theme/xxx 重写成真实静态路径，再由 location ^~ /themes/ 块接管并加缓存头。
- 在 phpMyAdmin 主
location /块内靠前位置加 rewrite：if ($args ~* "^route=/theme/(css|js|images)/(.+)$") { set $theme_path /themes/$1/$2; rewrite ^.*$ $theme_path last; } - 紧接着定义独立 location：
location ^~ /themes/ { alias /var/www/html/phpmyadmin/themes/; add_header Cache-Control "public, max-age=31536000, immutable"; expires 1y; } -
alias路径末尾必须有/，且该 block 必须放在所有location ~ \.php$规则之前，否则会被 PHP 处理器劫持 - 确认容器内真实路径：Docker 部署时是
/var/www/html/themes/，不是/usr/share/phpmyadmin/themes/
浏览器端要绕过 404 缓存和 stale 响应
你修好服务端后，浏览器可能还在用之前失败的 404 响应——HTTP 允许缓存 404，且默认不校验。
立即学习“PHP免费学习笔记（深入）”；
- 打开 DevTools → Network → 右键任意 CSS 请求 →
Clear browser cache（不是“清除浏览数据”，是右键菜单项） - 禁用缓存：Network 面板勾选
Disable cache，保持 DevTools 打开状态 - 检查每个 CSS 请求的响应头：必须含
Cache-Control: public, max-age=31536000, immutable，且状态码为200，Size 显示from disk cache - 别信右上角主题菜单显示名字就以为成功——点进去切换主题，看整个 UI 是否实时变色；若仅登录页生效、进库后回退，说明部分 CSS 仍走动态路由未被重写
真正卡住人的从来不是“怎么加缓存”，而是动态路由和静态路径之间的那层映射没打通。Nginx rewrite 和 alias 的顺序、路径拼接、权限、容器内实际位置——四者错一个，CSS 就静默失效。
