Thymeleaf 报错“模板解析异常”通常源于对 Java Bean 属性命名规范的不兼容：当实体字段名为 id（小写）时，Thymeleaf 默认尝试调用 getId() 方法，但若该方法未被正确识别（如 Lombok 未生效、getter 缺失或命名冲突），需显式使用符合 JavaBeans 规范的大写首字母形式 ${format.ID} 来访问。
thymeleaf 报错“模板解析异常”通常源于对 java bean 属性命名规范的不兼容：当实体字段名为 `id`（小写）时，thymeleaf 默认尝试调用 `getid()` 方法，但若该方法未被正确识别（如 lombok 未生效、getter 缺失或命名冲突），需显式使用符合 javabeans 规范的大写首字母形式 `${format.id}` 来访问。
在 Spring Boot + Thymeleaf 项目中，当你在模板中通过 ${format.id} 访问 JPA 实体的主键字段时出现 TemplateInputException（即使其他字段如 title、price 均能正常渲染），根本原因往往不是权限或配置问题，而是 JavaBeans 属性访问机制与 Thymeleaf 表达式解析的耦合细节。
根据 JavaBeans 规范，对于布尔类型字段（如 isAvailable），其 getter 应为 isAvailable()；而对于普通字段（如 id: Long），标准 getter 应为 getId()。Thymeleaf 在解析 ${format.id} 时，会按反射规则查找 getId() 方法。若该方法因以下任一原因不可见或未生成，则表达式求值失败：
- 实体类未显式声明
getId()方法，且未启用 Lombok 的@Getter（或@Data）注解； - Lombok 注解存在但未正确配置编译插件（如 IDE 未启用 annotation processing）；
- 字段名
id是保留关键字或与某些框架（如 Spring Data JPA 的代理逻辑）产生冲突，导致getId()被重写或屏蔽。
✅ 正确解决方案是：改用大驼峰形式 ${format.ID}
Thymeleaf 支持将单字母前缀字段（如 id, url, io）的 getter 映射为全大写形式（即 id → ID），这是对 JavaBeans 规范的扩展兼容。因此，将模板中所有 ${format.id} 替换为 ${format.ID} 即可绕过解析歧义：
<label th:each="format : ${Format}" th:attr="for='label' + ${format.title}" class="btn_order">
<sup th:text="${format.title}"></sup><sup th:text="${format.price}"></sup><input class="radio_settings" name="price_reload" th:value="${format.ID}" id>
th:attr="id='label' + ${format.title}"
type="radio"
hidden>
</label>
⚠️ 注意事项：
- 此写法仅适用于字段名为单小写字母开头的场景（如
id,url,ai），不适用于userId或orderId等多字符前缀字段； - 推荐长期方案：确保实体类具备标准 getter —— 显式添加
public Long getId() { return id; }，或使用@Data（含@Getter）并验证 Lombok 是否生效（检查编译后字节码或 IDE 提示）； - 不要依赖
${format.getId()}写法（Thymeleaf 不支持直接调用方法），始终使用属性式表达式${format.ID}或${format.id}（后者需 getter 可靠）； - Spring Security 配置与此错误无关，无需调整 CSRF 或权限规则。
总结：Thymeleaf 对 id 字段的解析具有特殊性。当 ${format.id} 失败时，优先尝试 ${format.ID}；若仍报错，请检查 Format 类是否真正拥有可访问的 getId() 方法（可通过调试器或日志输出 format.getClass().getDeclaredMethods() 验证）。
