根本原因是Nginx未正确识别.js、.css等后缀的MIME类型，导致浏览器收到application/octet-stream等错误类型而触发下载；常见于漏配include mime.types;或静态资源location优先级过低。
为什么 phpMyAdmin 的 JS/CSS 文件显示为下载而不是执行
根本原因是 nginx 没把 .js、.css 这类后缀识别为对应 mime 类型，浏览器收到 content-type: application/octet-stream 或空类型时，会直接触发下载。这不是 phpmyadmin 配置问题，而是 nginx 的 mime.types 未生效或被覆盖。
- 检查是否在 server 块里写了
include mime.types;—— 忘加这行是最常见原因 - 确认
mime.types文件真实存在（通常在/etc/nginx/mime.types），且路径与include指令一致 - 如果用了自定义 location 匹配静态资源（比如
location ~ \.(js|css|png)$），必须手动加types {}或显式设add_header Content-Type ...
phpMyAdmin 静态文件路径匹配要避开 root 覆盖
phpMyAdmin 的 js/、css/、vendor/ 等目录默认和 PHP 脚本混在同一目录下。如果 Nginx 的 location / 块里用了 try_files $uri $uri/ /index.php?$args;，但没提前拦截静态后缀，请求就会误进 PHP 处理流程，导致返回 500 或空白响应。
- 在
location /之前，加一个高优先级的静态资源 location：location ~ \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot)$ { expires 1y; add_header Cache-Control "public, immutable"; } - 确保这个 location 不带
root或alias错误 —— 如果 phpMyAdmin 是通过符号链接或子目录部署（如/usr/share/phpmyadmin），root必须指向其父目录，而alias要精确到该目录本身 - 避免用
alias+ 正则混用：比如alias /usr/share/phpmyadmin/;配合location ~ \.js$会导致路径拼接错误，改用root更稳
PHP 处理器干扰静态资源的典型配置错误
当 Nginx 把 .js 请求转发给 PHP-FPM（例如通过 fastcgi_pass），PHP 无法解析 JS 文件，会报 Access denied. 或直接返回空内容，浏览器控制台看到的是 200 状态但 MIME 类型错乱。
- 检查是否有类似这样的危险配置：
location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; # ... 其他 fastcgi 参数 }它会匹配theme/jquery.js.php这类文件，但更糟的是，如果写成location ~ \.php|js|css$（缺少括号分组），Nginx 会把所有.js当 PHP 执行 - 不要在 PHP location 里用
try_files回退到静态文件 —— 它不会重置 MIME 类型，JS 仍被当成 PHP 输出 - 验证方式：用
curl -I https://your.site/js/functions.js看响应头，Content-Type必须是application/javascript或text/css，不是text/html或空
浏览器缓存和 Nginx 缓存叠加导致旧 MIME 头残留
即使修好了配置，Chrome/Firefox 可能还沿用之前错误的 Content-Type 缓存（尤其是 304 响应），表现为刷新后依然下载 JS 文件。
- 清除浏览器缓存：不只是 Ctrl+F5，要清空「Cached images and files」
- 临时禁用 Nginx 缓存验证效果：
expires off;和add_header Cache-Control "no-store"加到静态 location 块里 - 重启 Nginx 后，用
nginx -t确认语法正确，再systemctl reload nginx—— 直接restart可能中断连接，reload 才真正重载配置
实际部署时最容易漏掉的是 include mime.types; 这一行，以及静态 location 块位置放得太靠后被其他规则覆盖。只要这两点对了，90% 的 MIME 类型问题就解决了。
立即学习“PHP免费学习笔记（深入）”；
