whitenoise 是轻量级 wsgi 中间件，使 django 能直接服务已收集的静态文件（static_root 内容），因 runserver 生产禁用静态服务、无缓存/压缩/并发支持；需 pip 安装、在 middleware 中 securitymiddleware 后紧接配置，并确保 collectstatic 已执行。
WhiteNoise 是什么，为什么不能直接用 Django 的 runserver 托管静态文件
WhiteNoise 是一个轻量级 WSGI 中间件，让 Django 应用自身能直接服务静态文件（如 CSS、JS、图片），不用额外配 Nginx。但它只适用于「已收集好」的静态资源，也就是运行过 python manage.py collectstatic 之后的 STATIC_ROOT 目录内容。
开发时用 runserver 能自动找 STATICFILES_DIRS，但生产环境关闭了这个逻辑——Django 明确不建议用它服务静态文件，因为没缓存头、不支持压缩、并发差。WhiteNoise 填的就是这个空，但前提是：你得先让静态文件“归位”。
怎么装 WhiteNoise 并接入 Django 的中间件链
安装后必须插在 MIDDLEWARE 列表靠前位置，且一定要在 SecurityMiddleware 之后、SessionMiddleware 之前。顺序错了会导致压缩失效或安全头丢失。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 运行
pip install whitenoise - 在
settings.py中添加：INSTALLED_APPS = [ 'whitenoise.runserver_nostatic', # 开发时禁用 runserver 的静态逻辑 # ... 其他 app ] - 在
MIDDLEWARE中插入：MIDDLEWARE = [ 'django.middleware.security.SecurityMiddleware', 'whitenoise.middleware.WhiteNoiseMiddleware', # 必须紧接 SecurityMiddleware 后 'django.contrib.sessions.middleware.SessionMiddleware', # ... ] - 确保
STATIC_ROOT已设置（如BASE_DIR / "staticfiles"），且不是STATICFILES_DIRS中的某个目录
WhiteNoiseMiddleware 的关键参数和默认行为坑点
WhiteNoise 默认启用 Gzip 和 Brotli 压缩，但只对特定 MIME 类型生效（比如 .css、.js、.svg），而不会处理 .woff2 或 .json——除非你显式配置 WHITENOISE_AUTOREFRESH 或 WHITENOISE_MIMETYPES。
-
WHITENOISE_USE_FINDERS = False（默认）：只从STATIC_ROOT读，不扫描STATICFILES_DIRS；设为True仅用于开发，生产禁用 -
WHITENOISE_MAX_AGE = 31536000（1年）：控制Cache-Control头，CDN 可据此缓存；若用 Cloudflare 等，可调低避免更新不及时 -
WHITENOISE_ALLOW_ALL_ORIGINS = False：默认禁止跨域请求；如果前端是独立域名（如 React 在localhost:3000），需设为True或配CORS中间件 - 注意：WhiteNoise 不处理上传文件（
MEDIA_URL），那些仍需 Nginx 或对象存储
部署后发现静态文件 404 或没压缩，怎么快速定位
常见现象是页面加载 CSS/JS 报 404，或 Network 面板里看到响应没 content-encoding: gzip。优先检查三件事：
- 确认已执行
python manage.py collectstatic --noinput，且STATIC_ROOT下有对应文件（比如staticfiles/css/base.css） - 看日志是否输出
WhiteNoise: Serving static file...；没这句说明中间件根本没触发，大概率是MIDDLEWARE顺序错或DEBUG = True时被跳过（WhiteNoise 在DEBUG=True下默认静默） - 用
curl -I https://yoursite.com/static/css/base.css检查响应头：Content-Encoding是否存在、Cache-Control是否含max-age、Content-Type是否正确（比如font/woff2缺失可能因 MIME 未注册）
最常被忽略的是：Django 的 STATIC_URL 必须以 / 结尾（如 /static/），否则 WhiteNoise 匹配路径失败；还有就是 collectstatic 没加 --clear 导致旧文件残留，覆盖新版本。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
