You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Django加载CSS报错MIME类型'text/html'不支持该如何解决

Django静态文件MIME类型报错解决指南

报错原因:Django未找到目标静态文件,返回了HTML格式的404页面,被浏览器识别为非法的样式表格式。

排查步骤

  • 检查DEBUG配置状态
    打开settings.py确认DEBUG值:
    • 开发测试阶段保持DEBUG = True,urls.py中追加的static()路由规则仅在DEBUG开启时生效
    • 生产环境DEBUG = False时,Django默认不处理静态资源,需使用Nginx/Apache等Web服务器托管静态文件目录
  • 修正静态文件查找配置
    你当前仅配置了STATIC_ROOT(生产环境收集静态文件的目标目录),缺少开发阶段的自定义静态目录查找规则,在settings.py中添加如下配置:
    # 开发阶段自定义全局静态文件查找目录,和模板中引用的静态文件存放路径对应
    STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")]
    # 将STATIC_ROOT改为和STATICFILES_DIRS不重复的路径,避免冲突,生产收集静态文件时会自动生成该目录
    STATIC_ROOT = os.path.join(BASE_DIR, "static_collected")
    
  • 检查文件名大小写匹配
    确认静态文件存放路径下的文件夹名、文件名和模板中写的CSS/Base.css完全一致,大小写必须匹配(Windows系统大小写不敏感,但Django静态查找逻辑、Linux部署环境均区分大小写)。
  • 验证静态文件访问
    直接在浏览器访问http://46.251.28.105:8000/static/CSS/Base.css,如果返回的是404页面,说明静态路径配置仍不正确,可执行python manage.py findstatic CSS/Base.css命令,查看Django的静态文件查找路径和匹配结果。
  • 生产环境额外操作
    部署到生产环境时,需先执行python manage.py collectstatic命令,将所有项目静态文件自动收集到STATIC_ROOT指定的目录,再配置Web服务器对/static/路径的请求指向该目录。

内容的提问来源于stack exchange,提问作者IKanekiI12

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.02 00:15:05