如何在Django模板中为无效字典查找开启异常抛出功能？

Django模板系统默认遇到无效字典查找时，会静默替换为空字符串。但针对特定字典查找，我希望系统抛出异常以辅助调试。例如存在如下字典：

colors = {"red": 1, "green": 2, "blue": 3}

当执行模板代码{{ colors.orange }}时，希望能抛出异常，该怎么做？

解决方案 #

你可以通过以下两种方案实现需求，均只针对指定字典生效，不会改变全局模板行为：

方案一：自定义模板过滤器 #

编写一个过滤器用于安全访问字典键，不存在时直接抛出异常：

1. 在Django应用目录下创建templatetags文件夹（若不存在），添加__init__.py和自定义过滤器文件（如safe_dict.py）：

from django import template

register = template.Library()

@register.filter
def safe_get(dictionary, key):
    if key not in dictionary:
        raise ValueError(f"字典中不存在键: {key}")
    return dictionary[key]

2. 在模板中加载并使用该过滤器：

{% load safe_dict %}
{{ colors|safe_get:"orange" }}

访问不存在的键时，会立即抛出ValueError，方便调试定位问题。

方案二：包装字典类 #

创建一个自定义字典子类，重写__getitem__方法，让它在键不存在时抛出异常，再将包装后的字典传入模板：

class StrictDict(dict):
    def __getitem__(self, key):
        if key not in self:
            raise KeyError(f"键 '{key}' 不存在于字典中")
        return super().__getitem__(key)

# 视图中使用包装后的字典
colors = StrictDict({"red": 1, "green": 2, "blue": 3})

之后在模板中直接调用{{ colors.orange }}，就会触发KeyError异常。

注意事项 #

• 建议仅在开发调试阶段使用上述方案，生产环境仍保持Django默认的静默处理，避免因无效键导致服务崩溃。

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