FreeMarker中null值与缺失值的区分及处理方案咨询

要实现「缺失变量标红，null值输出空文本」的需求，关键是利用FreeMarker异常类的内置方法区分两种情况，并自定义异常处理器，步骤如下：

1. 核心原理 #

默认情况下FreeMarker会把null值和缺失值视为等价，都抛出InvalidReferenceException，但该异常类提供了isMissing()方法——返回true表示变量完全不存在（缺失值），返回false表示变量存在但值为null。我们可以借助这个方法在异常处理器里做分支处理。

2. 自定义异常处理器 #

实现TemplateExceptionHandler接口，根据isMissing()的返回结果分别处理两种情况：

public class CustomExceptionHandler implements TemplateExceptionHandler {
    @Override
    public void handleTemplateException(TemplateException te, Environment env, Writer out) throws IOException {
        if (te instanceof InvalidReferenceException) {
            InvalidReferenceException ire = (InvalidReferenceException) te;
            String varName = ire.getReference().getAsString();
            if (ire.isMissing()) {
                // 缺失值：输出红色标记的变量名
                out.write("<span style='color:red'>[缺失变量: " + varName + "]</span>");
            } else {
                // null值：输出空文本
                out.write("");
            }
        } else {
            // 其他异常按默认逻辑输出栈信息
            te.printStackTrace(new PrintWriter(out));
        }
    }
}

3. 配置FreeMarker生效 #

需要关闭classic_compatible模式（该模式会把null和缺失值都转为空字符串，不会抛出异常），同时指定自定义的异常处理器：

Configuration cfg = new Configuration(Configuration.VERSION_2_3_32);
// 关闭兼容模式，确保null和缺失值都会触发异常
cfg.setClassicCompatible(false);
// 设置自定义异常处理器
cfg.setTemplateExceptionHandler(new CustomExceptionHandler());

注意事项 #

• 如果模板中使用了!默认值运算符（比如${foo!''}），会直接把null/缺失值替换为指定默认值，不会触发异常，因此要让缺失值进入异常处理流程，模板里不要给这类变量加!。

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