如何配置Django使开发模式检测{% static 'file' %}文件缺失并报错？

默认情况下Django开发模式（DEBUG=True）不会检查{% static %}引用的文件是否存在，这是正常设计，并非配置错误。要实现开发时检测静态文件缺失并抛出带路径的错误，可以通过以下方式实现：

方法1：自定义静态文件存储类 #

通过重写静态文件存储类的url方法，在生成URL前检查文件是否存在：

1. 在你的应用目录下新建storage.py文件，写入以下代码：

from django.contrib.staticfiles.storage import StaticFilesStorage
from django.core.exceptions import SuspiciousFileOperation
from django.conf import settings
import os

class CheckExistsStaticFilesStorage(StaticFilesStorage):
    def url(self, name):
        url = super().url(name)
        # 根据环境拼接文件路径
        if settings.DEBUG:
            file_path = os.path.join(settings.STATICFILES_DIRS[0], name)
        else:
            file_path = os.path.join(settings.STATIC_ROOT, name)
        if not os.path.exists(file_path):
            raise SuspiciousFileOperation(f"静态文件 '{name}' 不存在，路径：{file_path}")
        return url

2. 在settings.py中配置使用该存储类：

STATICFILES_STORAGE = '你的应用名.storage.CheckExistsStaticFilesStorage'

配置完成后，开发模式下渲染模板时，若引用的静态文件缺失，会直接抛出异常并显示包含错误路径的调试页面。

方法2：辅助检测工具（可选） #

若不想修改代码，可安装django-staticlint这类第三方工具，它能扫描模板中的静态文件引用，找出缺失的文件。不过该工具不会主动触发500错误，仅用于提前排查问题。

关于collectstatic忽略缺失文件的说明 #

collectstatic默认仅收集STATICFILES_DIRS和应用static目录中实际存在的文件，不会扫描模板中的引用。官方无内置功能让它检测模板引用，需依赖第三方工具实现。

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