本文旨在解决在使用Apache Freemarker模板引擎时，遇到的freemarker.core.NonHashException: Expected a hash, but this has evaluated to a string 错误。通过分析问题原因，提供使用Freemarker比较字符串的正确方法，帮助开发者避免类似错误，提升开发效率。
问题分析
在使用Freemarker模板引擎时，你可能会遇到如下错误：
freemarker.core.NonHashException: For "." left-hand operand: Expected a hash, but this has evaluated to a string (wrapper: f.t.SimpleScalar): ==> previousSearch.status [in template "ticket/search.ftlh" at line 22, column 66]
这个错误通常发生在尝试访问一个字符串的属性时，例如，使用.equals()方法。Freemarker认为.操作符是用来访问哈希（类似于Java中的Map或对象）的属性的，而你却试图在一个字符串上使用它。
例如，以下代码可能会导致该错误：
<#if previousSearch.status.equals("ALL")>
...
</#if>在这个例子中，previousSearch.status被认为是字符串，而.equals()方法是Java中字符串的方法，Freemarker并不直接支持这种用法。
解决方案：使用 == 比较字符串
在Freemarker中，比较字符串应该使用 == 操作符，而不是 .equals() 方法。
修改后的代码如下：
<#if previousSearch.status == "ALL"> ... </#if>
这样，Freemarker就能正确地比较字符串，避免NonHashException错误。
示例代码
假设你有一个名为 ticketSearchForm 的对象，包含一个 status 属性，你想根据 status 的值来设置
import lombok.Data;
@Data
public class TicketSearchForm {
private String status = "ALL";
//More fields...
}Freemarker模板代码如下：
<select name="status" id="status" class="form-control select2"> <option value="ALL" <#if ticketSearchForm.status == "ALL">selected</#if>>Alle anzeigen</option> <option value="OPEN" <#if ticketSearchForm.status == "OPEN">selected</#if>>Offen</option> <option value="DONE" <#if ticketSearchForm.status == "DONE">selected</#if>>Geschlossen</option> </select>
在这个例子中，我们使用 == 操作符来比较 ticketSearchForm.status 属性的值，从而正确地设置
注意事项
Freemarker与Java的区别： 务必记住，Freemarker与Java在处理字符串的方式上存在差异。不要将Java的习惯带入Freemarker模板中。
-
空值处理： 在比较字符串之前，最好先检查变量是否为空。可以使用 ?has_content 指令来判断变量是否存在且不为空。例如：
<#if ticketSearchForm.status?? && ticketSearchForm.status == "ALL"> ... </#if>
或者使用 ?default('') 来设置默认值，避免空指针异常。
<#if (ticketSearchForm.status?default('')) == "ALL"> ... </#if> 其他数据类型： == 操作符也适用于比较其他数据类型，例如数字和布尔值。
总结
在使用Freemarker模板引擎时，正确理解其语法和特性至关重要。特别是字符串比较，要记住使用 == 操作符，而不是 .equals() 方法。通过本文的讲解和示例，希望能帮助你解决NonHashException错误，编写出更加健壮和可维护的Freemarker模板代码。记住在比较之前进行判空处理，可以提高代码的健壮性。
