Thymeleaf遍历ArrayList渲染列表报Whitelabel错误，单条取值正常

• 从数据库查询的实体类集合传入前端后，直接取集合第0条的属性渲染可以正常运行
• 一旦用th:each做集合遍历渲染，就直接触发Whitelabel Error Page，无法正常加载页面
• 可正常运行的代码：

<span th:text="${item.get(0).getItemName()}"></span>

• 触发报错的循环代码：

<tr th:each="person, state : ${item}" class="row" th:classappend="${state.odd} ? 'odd-row' : 'even-row'">
    <td th:utext="${item.getItemName()}">Full Name</td>
</tr>

循环代码存在明确的取值对象引用错误：

• th:each 定义了当前遍历的迭代对象是person，代表集合中每一条独立的实体数据
• 但循环体的取值逻辑没有使用迭代对象person，反而调用了最外层传入的整个List集合对象的getItemName()方法
• Java的List类本身不存在getItemName()方法，Thymeleaf在解析表达式时会抛出方法找不到的异常，最终被全局异常处理器捕获，返回Whitelabel错误页
• 单独取集合首条数据的代码逻辑是正确的：先从List中取第0个实体对象，再调用实体类的getItemName()方法，所以不会触发异常

1. 调整前端循环的取值逻辑 #

将循环体里的属性取值从外层集合改为当前遍历的实体对象，同时可以简化Thymeleaf表达式的写法，不需要硬写get方法：
修正后的循环代码：

<tr th:each="person, state : ${item}" class="row" th:classappend="${state.odd} ? 'odd-row' : 'even-row'">
    <td th:text="${person.itemName}">Full Name</td>
</tr>

2. 优化后端代码的规范性 #

原后端代码存在命名混淆、空指针风险的问题，可按规范调整降低出错概率：

• 实体类按Java开发规范使用大驼峰命名（如将小写的item实体类改为Item），避免和集合变量名重名导致解析歧义
• 集合变量名和实体类名做明确区分，减少逻辑混淆
• 循环判断时增加空值防护，避免单条数据字段为空触发空指针

优化后的后端代码：

// 存储全量查询结果的集合，和实体类明确区分命名
List<Item> allItems = new ArrayList<>();
itemRepository.findAll().forEach(allItems::add);

List<Item> findList = new ArrayList<>();
String currentUserId = isExist.getId();
for (Item singleItem : allItems) {
    // 增加空值判断，避免字段为空时触发空指针
    if (currentUserId.equals(singleItem.getWhoAdd())) {
        findList.add(singleItem);
    }
}
model.addAttribute("item", findList);
return "item";

• Whitelabel Error Page本身不会展示具体的异常原因，遇到这类渲染报错直接看后端控制台的异常堆栈日志，能快速定位是方法缺失、空指针还是其他解析错误
• 既然单独取集合首条数据可以正常渲染，说明集合非空、实体类的属性getter方法是存在的，优先排查循环迭代时的对象引用是否正确，不要一开始就怀疑是后端集合传值的问题
• 非必要场景优先用th:text做文本转义渲染，th:utext会直接解析字符串内的HTML标签，如果字段是用户输入内容，存在XSS注入风险

内容的提问来源于stack exchange，提问作者godislikemyquestionsrets