Django 测试时出现 ValueError: Missing staticfiles manifest entry，本质是因 STORAGES 设置未被正确覆盖所致；即使设置了 STATICFILES_STORAGE，Django 5.0+ 已弃用该旧配置项，必须通过 STORAGES["staticfiles"]["BACKEND"] 显式指定存储后端才能生效。
django 测试时出现 valueerror: missing staticfiles manifest entry for 'assets/img/favicon.ico'，本质是因 storages 设置未被正确覆盖所致；即使设置了 staticfiles_storage，django 5.0+ 已弃用该旧配置项，必须通过 storages["staticfiles"]["backend"] 显式指定存储后端才能生效。
在 Django 4.2 及更高版本（尤其是 Django 5.0+）中，STATICFILES_STORAGE 已被正式弃用，取而代之的是统一的 STORAGES 设置字典。你的 base.py 中已正确定义：
STORAGES = {
"staticfiles": {
"BACKEND": "whitenoise.storage.CompressedManifestStaticFilesStorage",
},
}但问题在于：你在 settings/test.py 中仅覆盖了已失效的旧配置项：
# ❌ 错误：STATICFILES_STORAGE 在 Django 5.0+ 中被忽略 STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.StaticFilesStorage'
该设置不会影响 STORAGES 的行为，因此测试仍会使用 CompressedManifestStaticFilesStorage —— 它依赖 collectstatic 生成的 staticfiles.json 清单文件，而测试环境通常不执行 collectstatic，导致找不到 favicon.ico 等资源的哈希路径，从而抛出 manifest 缺失错误。
✅ 正确做法是完整覆盖 STORAGES 字典中的 staticfiles 后端：
# ✅ settings/test.py —— 正确覆盖 STORAGES
from .base import *
# 关键：显式替换 STORAGES 中的 staticfiles BACKEND
STORAGES = {
"staticfiles": {
"BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
},
}
# 其他测试专属配置（如 DATABASES、CACHES 等）可继续添加...? 补充说明：
StaticFilesStorage是最简静态文件存储类，不进行文件哈希重命名，也不依赖 manifest 文件，它直接按原始路径提供文件（如/static/assets/img/favicon.ico），完美适配测试场景。
验证是否生效
你可在测试中添加断言验证配置是否加载成功：
# tests/test_views.py
from django.conf import settings
def test_static_storage_backend():
assert settings.STORAGES["staticfiles"]["BACKEND"] == "django.contrib.staticfiles.storage.StaticFilesStorage"进阶建议：避免硬编码路径，提升可维护性
为防止未来因 STORAGES 结构变更导致配置遗漏，推荐使用 dict.update() 方式安全覆盖：
# settings/test.py
from .base import *
# 安全继承 base 中的 STORAGES，并仅覆盖 staticfiles 后端
STORAGES = {**STORAGES, "staticfiles": {"BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage"}}⚠️ 注意事项
-
不要在测试中启用 WhiteNoise 中间件：
whitenoise.middleware.WhiteNoiseMiddleware依赖CompressedManifestStaticFilesStorage的 manifest，若保留该中间件又切换为StaticFilesStorage，可能导致 404 或头信息异常。建议在测试设置中移除或条件禁用：# settings/test.py MIDDLEWARE = [m for m in MIDDLEWARE if not m.startswith("whitenoise.")] -
确保
STATIC_ROOT和STATICFILES_DIRS不冲突：测试环境下STATIC_ROOT（如./staticfiles）无需实际存在，StaticFilesStorage会直接从STATICFILES_DIRS和应用static/目录读取文件。 -
模板中引用静态文件需规范：始终使用
{% static 'assets/img/favicon.ico' %}，而非硬编码路径，以确保与存储后端解耦。
修复后，test_index_view 将不再因静态文件解析失败而中断，Django 模板渲染流程可完整执行，Client().get(reverse('index')) 将稳定返回 200 响应。这一配置变更既符合 Django 最新最佳实践，也彻底解耦了测试逻辑与生产级静态文件部署机制。
