根本原因是WhiteNoise只从STATIC_ROOT读取已收集的静态文件，不扫描STATICFILES_DIRS；若未执行collectstatic、STATIC_ROOT路径错误或权限不足，即返回404。
为什么 collectstatic 后 WhiteNoise 找不到静态文件？
根本原因是 WhiteNoise 只在 STATIC_ROOT 目录下查找已收集的文件，它**不读取 STATICFILES_DIRS 中的源文件**。如果你跳过 python manage.py collectstatic，或者 STATIC_ROOT 配置为空、路径错误、权限不足，WhiteNoise 就会返回 404。
实操建议：
- 确认
STATIC_ROOT = BASE_DIR / "staticfiles"（推荐用pathlib），且该目录可写 - 运行
python manage.py collectstatic --noinput，观察输出是否列出实际拷贝的文件数 - 检查输出末尾是否有
127 static files copied to 'staticfiles'这类提示；若为0 static files copied，说明STATICFILES_DIRS未正确声明或路径不存在 - 开发时不要依赖
WhiteNoise提供未收集的源文件——那是django.contrib.staticfiles的runserver做的事
如何让 WhiteNoise 正确处理 CSS/JS 中的相对路径引用？
WhiteNoise 本身不解析 CSS 或 JS 内容，它只按请求路径返回对应文件。如果 style.css 里写了 background: url("../images/logo.png")，而该 CSS 经 collectstatic 后被移到 staticfiles/css/style.css，那么浏览器请求的其实是 /static/css/../images/logo.png → /static/images/logo.png。所以关键在**确保所有静态资源都被纳入收集范围，并保持相对结构一致**。
实操建议：
- 把项目图片、字体等资源统一放在
static/子目录下（如static/images/、static/fonts/），而不是散落在各 app 的static/里 - 在
settings.py中显式声明：STATICFILES_DIRS = [BASE_DIR / "static"]，避免遗漏 - 使用
{% static %}模板标签生成绝对路径（如{% static "images/logo.png" %}），而非硬编码相对路径 - 若必须用 CSS 相对引用，确保
collectstatic后目录层级与开发时一致（例如所有 CSS 放static/css/，对应图片放static/images/）
Django 4.2+ 中 WhiteNoise 中间件顺序为什么必须在 SecurityMiddleware 之后？
因为 SecurityMiddleware 会添加 X-Content-Type-Options、X-Frame-Options 等响应头，而 WhiteNoise 是中间件，它生成的静态文件响应也需要这些安全头。如果顺序颠倒（WhiteNoise 在前），静态响应就绕过了安全头设置。
实操建议：
- 检查
MIDDLEWARE列表，确保顺序类似这样：
['django.middleware.security.SecurityMiddleware', 'whitenoise.middleware.WhiteNoiseMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', ...]
WhiteNoise 放在 SecurityMiddleware 前面，也不应放在 CommonMiddleware 后面（它需要早于 URL 解析逻辑）django-axes 或自定义认证中间件，WhiteNoise 仍应紧接在 SecurityMiddleware 之后——静态文件不该触发登录拦截或频率限制生产环境部署时如何验证 WhiteNoise 是否生效？
最直接的方式是关掉 Django 开发服务器，用 gunicorn 或 uvicorn 启动，并检查静态资源 HTTP 响应头和内容。重点看两个信号：是否返回 200、是否有 X-Whitenoise 响应头。
实操建议：
- 启动后访问
/static/css/base.css，用curl -I查看响应头：curl -I http://localhost:8000/static/css/base.css，确认含X-Whitenoise: Version/6.6.0（版本号依安装版本而定） - 对比开发模式（
DEBUG=True）下同一 URL 的响应头——此时没有X-Whitenoise，且Content-Length可能不同 - 如果返回 404，先确认
STATIC_ROOT下确实存在该文件（如staticfiles/css/base.css），再检查 Nginx 是否意外拦截了/static/路径（此时应禁用 Nginx 的静态文件服务，交由 WhiteNoise 处理） - 注意
DEBUG=False时 Django 默认不提供静态文件，此时完全依赖WhiteNoise—— 忘记设DEBUG=False却又没配 WhiteNoise，就会全站静态资源失效
WhiteNoise 的配置难点不在代码量，而在路径、顺序、环境开关三者的咬合。最容易被忽略的是：本地 DEBUG=True 时一切正常，一上生产就 404，往往是因为 collectstatic 没跑、STATIC_ROOT 权限不对、或中间件顺序错位。每次部署前用 curl -I 抓一个 CSS 文件的头，比翻日志快得多。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
