Django开启DEBUG模式时admin站点样式表已下载但样式不生效问题

你遇到的问题核心是DEBUG模式下Django内置的静态文件服务返回的CSS/JS等静态资源的Content-Type响应头错误：

• 浏览器成功获取到了CSS文件，但因为响应头里Content-Type被错误设置为text/plain，现代浏览器基于安全策略会拒绝把text/plain类型的文件当作CSS渲染，因此页面显示无样式
• 你在开发者工具中修改CSS内容后临时生效，是因为修改的是浏览器内存中已加载的文件内容，此时浏览器绕过了原响应头的MIME校验直接应用样式，刷新后重新拉取资源会再次触发校验，所以回到无样式状态
• 使用Whitenoise关闭DEBUG后样式正常，是因为Whitenoise会正确设置静态资源的Content-Type响应头，符合浏览器渲染要求
• 本地保存的页面样式正常，是因为保存到本地后系统会根据文件后缀名识别CSS类型，不再依赖原服务端返回的响应头

该问题90%以上出现在Windows系统环境下：Django内置静态服务依赖Python标准库的mimetypes模块判断文件类型，而如果Windows系统注册表中.css后缀对应的MIME类型被第三方软件修改为text/plain，就会导致Django返回错误的响应头。
如果开启了Django的SECURE_CONTENT_TYPE_NOSNIFF = True安全配置，会进一步加强浏览器的MIME校验，即使没有系统级的MIME错误也可能触发该问题。

方法1：修复系统MIME类型注册（推荐，针对Windows系统） #

1. 按下Win+R输入regedit打开注册表编辑器
2. 定位到路径HKEY_CLASSES_ROOT\.css
3. 查看右侧的Content Type值，确保设置为text/css，如果不是则修改为该值
4. 重启Django服务即可生效

方法2：强制Django指定静态资源的MIME类型 #

如果不想修改系统配置，可以在项目的urls.py中自定义静态文件服务逻辑，强制指定正确的响应头：

from django.conf import settings
from django.conf.urls.static import static
from django.views.static import serve

def custom_static_serve(request, path, document_root=None, show_indexes=False):
    response = serve(request, path, document_root, show_indexes)
    if path.endswith('.css'):
        response['Content-Type'] = 'text/css'
    elif path.endswith('.js'):
        response['Content-Type'] = 'application/javascript'
    return response

if settings.DEBUG:
    urlpatterns += static(settings.STATIC_URL, view=custom_static_serve, document_root=settings.STATIC_ROOT)

方法3：DEBUG模式下也使用Whitenoise提供服务 #

直接在DEBUG模式下启用Whitenoise替代Django自带的静态文件服务，修改settings.py即可：

DEBUG = True
INSTALLED_APPS = [
    # 要放在django.contrib.staticfiles前面
    'whitenoise.runserver_nostatic',
    'django.contrib.staticfiles',
    # 其余应用保持不变
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    # 放在中间件列表最顶部位置
    'whitenoise.middleware.WhiteNoiseMiddleware',
    # 其余中间件保持不变
]

内容的提问来源于stack exchange，提问作者rghome