JS和CSS加载失败:MIME类型怎么查

控制台提示脚本或样式的MIME类型不受支持时,先核对服务器实际返回了什么。地址以.js或.css结尾,不保证返回内容就是脚本或样式;状态码200也可能对应登录页、错误页或前端首页。

宝乐云原创示意图:按实际响应内容区分路径错误和MIME类型错误
图:先确认响应体是什么,再决定检查路径、登录跳转,还是Content-Type。

一、同时看状态码、响应头和响应内容

打开开发者工具的“网络(Network)”,勾选“保留日志”,在工具保持打开时勾选“停用缓存”,再刷新页面。选择报错的JS或CSS请求,查看状态码、完整URL、“响应标头”中的Content-Type,以及“响应(Response)”里的内容。

看到的结果 优先处理方向
404、403或5xx 检查文件路径、访问规则或服务错误,不先修改MIME
先跳转,最终返回登录页 检查资源是否被登录验证或跳转规则接管
200,但正文是HTML 检查错误页、登录页或前端路由回退
200,正文确为JS/CSS,类型却错误 检查静态文件类型映射或后端响应头

如果JS返回的是单页应用的首页,参照Vue、React前端上线:刷新404处理检查静态资源回退,本篇不重复部署配置。若看到304或缓存命中,先取得一次新的完整响应,避免只凭旧缓存判断。

二、把登录跳转与资源文件分开检查

保留日志后查看301、302、307或308的跳转链与Location。资源可能先被重定向到登录页,再以200返回HTML,因此只看最后一个状态码容易误判。

Linux终端可对报错资源执行GET请求,先查看原始状态与响应头:

curl -sS -D - -o /dev/null 'https://example.com/assets/app.js'

URL应替换为浏览器中实际失败的地址。此命令不自动跟随跳转,也不携带浏览器登录状态。受保护资源应按真实会话核查,不能因为curl被送到登录页就断定浏览器也收到同样内容。

确属公开构建资源时,只修正该资源路径的登录拦截或引用地址,不要把整个后台、接口或私有下载目录改成免登录。

三、内容正确时,再修Content-Type

CSS应返回text/css。JavaScript推荐text/javascript;浏览器也接受部分历史JavaScript类型,例如application/javascript,不要仅因它不是text/javascript就判定错误。text/html或application/octet-stream不能代替正确脚本类型。

Nginx直接提供静态文件时,先确认实际运行实例和配置入口,再检查加载的配置。以下为常见系统安装命令,输出只在本机核对,不整份公开其中的上游地址或凭据:

sudo nginx -T

确认对应配置加载了实际存在的mime.types,并检查css、js及项目使用的mjs扩展名映射。常见引用形式如下,路径以本机安装为准:

include /etc/nginx/mime.types;

还要检查目标server/location是否重新定义了types或清空映射。已有JS条目时修改对应条目,保留其他类型,不要用只含js的表替换整份映射。不要通过全站设置default_type text/javascript把错误页也伪装成脚本。

若资源由后端应用或代理上游返回,类型可能由上游响应决定,修改静态mime.types未必有效。面板管理的Nginx应检查面板实际运行实例,不能默认系统命令就是同一套配置。改动前备份;配置检查通过后再重载对应实例。

四、module脚本需要严格匹配类型

<script type="module">及其导入的JavaScript模块会进行严格MIME检查。移除X-Content-Type-Options: nosniff也不能代替正确类型。普通脚本和样式启用nosniff时,同样需要符合对应类型要求;给script标签补type属性不会修复服务器响应头。

五、用原页面完成复测

刷新后确认资源响应内容正确、Content-Type匹配且不再发生意外跳转,再测试样式、按钮与动态导入页面。若源站已修好而外部仍旧,继续核对CDN或Service Worker返回的版本,不要反复改同一份源站配置。

需要协助时,提供失败URL、状态码、Content-Type、跳转链和响应内容开头的脱敏截图。请勿提交Cookie、Authorization或带密钥的请求信息。