在 Jinja 的 Environment 初始化时设置 undefined=StrictUndefined，缺失变量就不会悄悄变成空白：模板尝试输出、遍历或判断这个未定义值时，会抛出 UndefinedError。它适合暴露上下文漏传字段、模板变量拼写错误，但不会替你检查数据类型，也不会保证未执行分支里的变量齐全。

下面做一个通知卡片生成器：标题和收件人必填，备注可选。示例适用 Python 3.10+、Jinja 3.1.x。官方文档地址：https://jinja.palletsprojects.com/en/stable/。

从一张缺标题的通知卡片开始

假设数据层交付的字段是 title，模板却写成 titlle。卡片其他内容仍然能出现，标题区域却空白。与其追查字体或页面样式，不如先让“缺字段”成为一个可识别的失败。

本项目约定 title 与 recipient 必须提供，note 可以不提供。Environment 持有 StrictUndefined 配置，DictLoader 持有 card.html 模板，render 接收 context 字典。这几个对象的关系清楚后，错误通常能落到某个字段，而不是笼统地归因于“模板没渲染”。

建立严格的模板环境

新建虚拟环境并安装依赖，随后把完整 Python 代码保存为 demo.py。这里只在字符串中放置可信的固定模板，方便读者聚焦变量问题。

# 独立环境便于锁定项目实际使用的依赖
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "Jinja2>=3.1,

from jinja2 import (
    DictLoader, Environment, StrictUndefined,
    UndefinedError, select_autoescape,
)

SOURCE = """
{# 故意把必填标题拼错，模拟模板与数据的契约不一致 #}
{{ titlle }}
收件人：{{ recipient }}
备注：{{ note | default('未填写') }}
"""

# 在加载任何模板之前确定未定义策略与HTML转义
env = Environment(
    loader=DictLoader({"card.html": SOURCE}),
    undefined=StrictUndefined,
    autoescape=select_autoescape(["html", "xml"]),
)
template = env.get_template("card.html")
context = {"title": "设备维护通知", "recipient": "运维组"}

try:
    rendered = template.render(context)
except UndefinedError as exc:
    # 本地演示显示错误原因；线上仅在受控日志中保留详细信息
    print(f"卡片生成失败：{exc}")
else:
    # 只有整次渲染成功才把成品交给后续处理
    print(rendered)

这个例子的预期是进入异常分支，错误指向 titlle 未定义。本文未运行该项目，不把预期报错当作实测结果。代码用 render 一次返回完整字符串，异常时不交付 rendered，也没有写入半张卡片。

修复字段名而不是吞掉异常

对照模板中的 titlle 与上下文中的 title，应修改模板拼写，不要在字典里增加同样拼错的字段，更不要捕获异常后返回空字符串。如果上游漏传了真正的 title，则应补齐上游数据，而不是换成 default 让必填字段消失。

{# 标题和收件人是必填字段；这里只给备注提供缺失时的替代文字 #}
{{ title }}
收件人：{{ recipient }}
备注：{{ note | default('未填写') }}

把 SOURCE 中的模板替换为这段后，保持原来的 context 即可。备注缺失会得到“未填写”，标题则必须真正存在。实际排查先确认使用的模板文件，再确认 render 接收到的数据键；不要只看构造数据的某个中间函数。

缺失通常在相关表达式被求值时暴露，而不是 get_template 成功就代表数据完整。一次失败也不保证列出所有缺失字段：先处理当前异常，再覆盖其他业务输入。

让可选字段拥有明确规则

default 的普通用法处理未定义值，不自动把 None、空字符串、0 或 False 都当成缺失。第二参数 true 会扩大到假值；如果 0 是合法数量，这种扩大就可能改写业务含义。规则应由字段契约决定，而不是每个模板作者随手加 true。

{# 同时允许备注缺失或为None，但保留空字符串等其他已定义值 #}
{% if note is defined and note is not none %}
  
备注：{{ note }}
{% else %}
  
备注：未填写
{% endif %}

不要用 if note 来检查存在性：严格模式下未定义值的布尔判断也会报错。嵌套路径同样要照顾父对象；例如 profile 不存在时，profile.nickname 的访问可能在 default 接手之前就失败。可以在数据层提供稳定的 profile 字典，或先判断父对象，再读取子字段。

把严格模式接到真实项目

把 Environment 的构造集中到应用启动处，模板开始加载前就确定策略。已有项目若还通过其他入口直接创建 Template，需让它们使用同一套环境配置，否则某些页面严格、某些页面仍宽松，会使排错结论互相矛盾。

渲染入口记录模板名和业务请求标识，但不要把整个上下文字典写进日志；其中可能含个人信息。线上响应给出通用错误提示，详细异常留在访问受控的日志中。不要以“避免用户看到错误”为由交付空白邮件或空白报告。

StrictUndefined 与 HTML 自动转义是不同设置：一个针对缺失值，一个针对输出转义。业务还应自行确认类型、长度与必填约束，严格模板不是数据模型或安全沙箱的替代品。对于流式生成，失败前可能已有内容被消费；需要完整成品的任务应先完成渲染，再进入交付环节。

用几组输入观察覆盖范围

# 在修正模板前后分别执行，观察错误与成品的差异
python demo.py
# 查看本地安装的版本，供依赖记录使用
python -m pip show Jinja2

读者可自行尝试原始错拼模板、修正模板、删去 title、传入 note=None、传入 note=0。关注的不是“页面能出现”，而是必填字段缺失是否可见、可选字段是否按约定呈现。本文不声称已执行这些输入。

为什么开启严格模式后仍有变量没报错？

可能没有走到引用该变量的分支，或模板已用 default、is defined 等明确处理它。严格模式在运行求值时发挥作用，不是一次扫描全站模板。

模板里的 None 为什么不触发缺失错误？

键存在且值为 None，不是未定义值。是否允许它，应在数据层和模板契约里另行规定。

可以用默认值修复所有报错吗？

不宜。默认值适合真正可选的字段；必填字段的默认值会让漏传与错拼重新变成看似成功的渲染。

这套最小项目的取舍很明确：必填数据让错误暴露，可选数据给出有意设计的替代规则，渲染失败不交付半成品。相关语义见 StrictUndefined API 和 default 过滤器文档。