本文旨在解决在 thymeleaf 片段中动态设置 `th:field` 属性时遇到的常见问题。通过分析直接传递对象引用导致 `notreadablepropertyexception` 的原因，文章详细介绍了正确的解决方案：即在调用片段时传递字段名称的字符串字面量，并在片段内部利用 thymeleaf 的预处理功能 (`__${field}__`) 来动态构建 `th:field` 属性值，从而实现灵活可复用的表单组件。

Thymeleaf 片段中动态 th:field 的实现

在构建可复用的 Thymeleaf 片段时，我们经常需要让片段内部的表单元素（如 ）的 th:field 属性能够根据外部调用动态设置。然而，直接将字段名称作为片段参数传递并尝试在 th:field 中引用，往往会导致运行时错误。本教程将深入探讨这一问题，并提供一个标准且有效的解决方案。

问题背景与常见误区

假设我们有一个用于生成下拉列表的 Thymeleaf 片段，我们希望它能够接收一个参数 field，并将其值动态地应用于 元素的 th:field 属性。

原始片段定义示例 (错误示范):

片段调用示例 (错误示范):

在这种设置下，当执行代码时，会抛出 org.springframework.beans.NotReadablePropertyException 异常，错误信息通常会指出 Invalid property 'field' of bean class [...]。

错误原因分析:

th:field 处理器期望接收一个字符串字面量，该字面量代表了当前表单绑定对象（通常是 Spring 表单的 modelAttribute）的一个属性路径。当你在片段内部写 th:field="*{field}" 时，Thymeleaf 和 Spring 尝试在表单绑定对象上查找一个名为 field 的属性，而不是将 field 解释为一个变量，并使用其 值 作为属性路径。

在上述错误的片段调用中，field=*{projectOptions.zMatrixIndex} 实际上是将 projectOptions.zMatrixIndex 的 对象引用 而不是其 字符串路径 传递给了片段参数 field。即使传递的是字符串，th:field="*{field}" 仍然会尝试查找名为 "field" 的属性。

解决方案：字符串字面量与 Thymeleaf 预处理

解决此问题的关键在于两点：

1. 在调用片段时，将字段名称作为 字符串字面量 传递。
2. 在片段内部，使用 Thymeleaf 的 预处理语法 来动态构建 th:field 属性的值。

1. 片段调用方式的修改

不再传递对象引用，而是传递一个包含完整属性路径的字符串。

正确的片段调用示例:

这里，field='projectOptions.zMatrixIndex' 明确地将字符串 "projectOptions.zMatrixIndex" 赋值给片段参数 field。

2. 片段内部 th:field 的修改

在片段内部，我们需要利用 Thymeleaf 的预处理功能。预处理允许在 Thymeleaf 处理器执行之前，先对表达式进行求值。语法是 __${...}__。

正确的片段定义示例:

工作原理:

1. 当 Thymeleaf 处理 标签时，它首先遇到 th:field="*{__${field}__}"。
2. 预处理器 __${field}__ 会首先被评估。由于 field 参数现在包含字符串 "projectOptions.zMatrixIndex"，预处理的结果就是 "projectOptions.zMatrixIndex"。
3. 因此，实际传递给 th:field 处理器的是 th:field="*{projectOptions.zMatrixIndex}"。
4. 此时，th:field 处理器能够正确地在表单绑定对象上查找 projectOptions.zMatrixIndex 属性，并生成相应的 id、name 和 value 属性。

总结与注意事项

• th:field 的本质: th:field 处理器需要一个表示属性路径的字符串字面量。它不会自动解析片段参数作为动态路径的一部分，除非显式使用预处理。
• 预处理 (__${...}__) 的作用: 预处理在 Thymeleaf 模板引擎解析标签属性之前执行，它允许你动态地构建属性值，特别是在需要将变量内容作为另一个表达式或属性值的一部分时非常有用。
• 可复用性: 采用这种方法，你的下拉列表片段变得高度可复用，可以轻松地应用于不同的表单字段，只需在调用时传递相应的字段路径字符串即可。

通过理解 th:field 的工作机制和 Thymeleaf 预处理的强大功能，你可以更有效地构建灵活且可维护的 Web 界面组件。