
freemarker 模板中直接使用 `isxxx()` 方法名会导致“期望 boolean 却得到 method+sequence”错误;应优先访问对应 javabean 属性(如 `xxx`),或显式调用方法(`isxxx()`)并加括号,确保获取返回值而非方法引用。
在 FreeMarker 中对布尔值做条件判断时,常见误区是将 Java Bean 的 getter 方法名(如 isOtherInsurance())直接当作属性使用:
<#if documentData.isOtherInsurance>
FreeMarker 默认遵循 JavaBeans 规范:若类中定义了形如 public boolean isOtherInsurance() 的方法,它会自动将其映射为名为 otherInsurance 的属性(即去掉 is 前缀,首字母小写)。因此,推荐写法是直接访问属性名:
<#if documentData.otherInsurance>✔ Да
<#else>✘ Нет
#if>
✅ 这样 FreeMarker 会自动调用 isOtherInsurance() 并取其返回的 boolean 值,语义清晰且符合模板最佳实践。
⚠️ 若因历史原因无法修改 Java 类(例如方法声明为 public Boolean isOtherInsurance() — 返回 Boolean 而非原始 boolean),或该方法未遵循标准命名(如误写为 getIsOtherInsurance()),则需显式调用方法并加括号,强制执行:
<#if documentData.isOtherInsurance()>✔ Да
<#else>✘ Нет
#if>
注意:() 不可省略,否则 documentData.isOtherInsurance 仍表示方法引用(SimpleMethodModel),而非执行结果。
? 补充建议:
- 避免在 Java 端使用 Boolean isXxx()(包装类型 + is 前缀),易引发空指针与模板兼容问题;应统一为 boolean isXxx() 或 Boolean getXxx();
- 在模板中可结合默认值操作增强健壮性,例如 (仅当属性可能为 null 且 Java 类型为 Boolean 时适用);
- 使用 ?has_content 或 ?? 判断存在性前,请确认目标确实是字符串或容器类型——对布尔值不适用。
总之,核心原则是:FreeMarker 条件表达式中必须出现一个明确的 boolean 值,而非方法、null 或其他类型。通过规范 Java Bean 命名或显式方法调用,即可彻底规避此类类型错误。










