第一段引用上面的摘要
本文旨在解决在使用 Apache Freemarker 模板引擎时遇到的 NonHashException 异常，该异常通常发生在尝试访问对象属性时，Freemarker 却将对象识别为字符串。通过分析问题原因和提供解决方案，帮助开发者正确地在 Freemarker 模板中访问和使用对象属性，避免类型不匹配导致的错误。
在使用 Spring Boot 和 Apache Freemarker 构建 Web 应用时，经常需要将 Java 对象传递到 Freemarker 模板中进行渲染。然而，有时会遇到 freemarker.core.NonHashException 异常，提示 "Expected a hash, but this has evaluated to a string"。 这通常发生在试图通过点号（.）访问对象属性时，Freemarker 引擎错误地将该对象识别为字符串。
问题分析
Freemarker 模板引擎对数据类型的处理与 Java 有所不同。当你在模板中使用点号（.）访问对象属性时，Freemarker 期望左侧的操作数是一个哈希表（Hash），也就是一个可以像 Map 一样通过键值对访问数据的对象。 如果 Freemarker 认为左侧的操作数是一个字符串，就会抛出 NonHashException 异常。
例如，假设你有一个 Java 类 TicketSearchForm，包含一个 status 属性：
import lombok.Data;
@Data
public class TicketSearchForm {
private String status = "ALL";
//More fields...
}你将 TicketSearchForm 对象 previousSearch 传递到 Freemarker 模板中，并尝试使用以下代码进行比较：
<#if previousSearch.status.equals("ALL")>selected这段代码在 Java 中是完全有效的，但是在 Freemarker 中却可能抛出 NonHashException 异常。
解决方案
问题的根源在于 Freemarker 处理字符串的方式与 Java 不同。在 Freemarker 中，字符串比较应该使用 == 运算符，而不是 equals() 方法。
因此，正确的 Freemarker 代码应该如下所示：
<#if previousSearch.status == "ALL">selected
将 equals() 方法替换为 == 运算符后，Freemarker 就可以正确地比较字符串，避免 NonHashException 异常。
示例代码
以下是一个完整的示例，展示了如何在 Freemarker 模板中使用 == 运算符比较字符串：
在这个例子中，previousSearch.status 属性的值将与 "ALL"、"OPEN" 和 "DONE" 进行比较，如果匹配，则对应的
注意事项
- 字符串比较： 在 Freemarker 中，始终使用 == 运算符进行字符串比较，而不是 equals() 方法。
- 对象属性访问： 确保传递到 Freemarker 模板中的对象属性是可访问的，并且具有正确的类型。
- 数据模型： 仔细检查传递到 Freemarker 模板中的数据模型，确保包含所有需要的属性，并且属性名称正确。
- 异常信息： 仔细阅读 Freemarker 抛出的异常信息，通常可以提供有关问题的线索。
总结
NonHashException 异常是 Freemarker 中常见的错误，通常是由于字符串比较方式不正确导致的。通过使用 == 运算符代替 equals() 方法，可以有效地解决这个问题。此外，还需要注意对象属性的访问权限和数据模型的正确性，以确保 Freemarker 模板能够正确地渲染数据。理解 Freemarker 的数据类型处理方式，是避免此类问题的关键。
