Django 测试时因 STORAGES 设置未被正确覆盖，导致模板渲染意外触发 CompressedManifestStaticFilesStorage 的哈希校验，引发 ValueError: Missing staticfiles manifest entry 错误；根本解法是在测试配置中显式重写 STORAGES["staticfiles"]["BACKEND"]，而非仅设置已弃用的 STATICFILES_STORAGE。
django 测试时因 `storages` 设置未被正确覆盖，导致模板渲染意外触发 `compressedmanifeststaticfilesstorage` 的哈希校验，引发 `valueerror: missing staticfiles manifest entry` 错误；根本解法是**在测试配置中显式重写 `storages["staticfiles"]["backend"]`**，而非仅设置已弃用的 `staticfiles_storage`。
你遇到的错误看似简单，实则揭示了 Django 5.0+ 中一个关键的配置演进：STATICFILES_STORAGE 已被正式弃用，全面由 STORAGES 字典接管。你的 settings/base.py 中已正确定义：
STORAGES = {
"staticfiles": {
"BACKEND": "whitenoise.storage.CompressedManifestStaticFilesStorage",
},
}而 settings/test.py 中仅写了：
# ❌ 无效！Django 5.1+ 忽略此设置 STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.StaticFilesStorage'
这正是问题核心——Django 完全忽略 STATICFILES_STORAGE（即使它仍存在于文档兼容层），优先读取 STORAGES["staticfiles"]["BACKEND"]。因此，测试时模板引擎（如 {% static %} 标签）仍会调用 CompressedManifestStaticFilesStorage，尝试查找 assets/img/favicon.ico 的哈希化路径（如 assets/img/favicon.a1b2c3d4.ico），但 collectstatic 未在测试中运行，manifest.json 为空，最终抛出 Missing staticfiles manifest entry。
✅ 正确修复方式（在 settings/test.py 中）：
from .base import *
# ✅ 正确：覆盖 STORAGES 配置，禁用 Manifest 逻辑
STORAGES = {
"staticfiles": {
"BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
# 可选：避免 collectstatic 被意外调用
"OPTIONS": {"location": "/tmp/django-test-static/"},
},
}
# ✅ 可选但推荐：显式关闭 WhiteNoise（防止中间件干扰）
MIDDLEWARE = [m for m in MIDDLEWARE if m != "whitenoise.middleware.WhiteNoiseMiddleware"]
# ✅ 可选：确保 STATIC_ROOT 不冲突（测试无需实际收集）
import tempfile
STATIC_ROOT = tempfile.mkdtemp()? 为什么 StaticFilesStorage 是安全选择？
- 它不生成哈希文件，不依赖
manifest.json； - 直接按原始路径（如
/static/assets/img/favicon.ico）提供文件； - 专为开发与测试设计，零构建开销。
⚠️ 注意事项与最佳实践
-
不要在测试中运行
collectstatic：它耗时、非必要，且可能因权限或路径问题失败； -
验证配置生效：在测试中加入断言确认后端类型：
def test_static_storage_backend(): from django.contrib.staticfiles.storage import staticfiles_storage assert staticfiles_storage.__class__.__name__ == "StaticFilesStorage" -
WhiteNoise 中间件需同步禁用：若保留
WhiteNoiseMiddleware，它仍可能尝试处理静态请求并报错（尤其当STATIC_URL匹配时）； -
生产与测试严格分离：
STORAGES配置应像数据库、缓存一样，在settings/production.py和settings/test.py中彻底隔离。
总结来说，这不是 pytest 或模板的 bug，而是 Django 配置模型升级带来的“静默不兼容”。牢记：在 Django ≥ 5.0 中，STORAGES 是唯一权威的静态文件存储配置入口。一次精准覆盖，即可让所有基于模板的视图测试（test_index_view 等）稳定通过，无需生成 manifest、无需运行 collectstatic、更无需妥协测试速度与可靠性。
