Thymeleaf中嵌套遍历列表无法正常显示applicationReports包名问题

高频踩坑点（覆盖90%以上同场景问题） #

• API请求未返回目标字段（最容易被忽略的根源）
  Android Management API的设备详情接口采用按需返回字段的规则，默认响应中不包含applicationReports内容，必须在接口请求参数里显式指定要返回的字段（比如配置fields=*或单独将applicationReports加入返回字段列表），否则后端拿到的Device对象里该列表本身就是null或空值，前端遍历逻辑无论写得对不对都不会有内容渲染。
• 属性访问路径不符合实际序列化规则
  第一，核对SDK对象的序列化结果：多数项目会用Jackson将API返回的对象转为前端模型，默认会将驼峰字段转为下划线命名，比如applicationReports会被序列化为application_reports，这种情况下在Thymeleaf里直接写驼峰路径会取不到值，且不会抛出报错。
  第二，检查循环作用域的变量指向：外层通过th:each遍历设备列表时，内层遍历必须明确绑定外层的循环变量。比如外层循环变量定义为dev，取嵌套设备对象的路径应该是${dev.device.applicationReports}，如果漏写外层变量直接取根作用域的device对象，会因为上下文找不到对应变量导致渲染空白。
• 无空值保护导致的静默渲染失败
  Thymeleaf对null值的表达式默认不会抛出异常，只要嵌套访问路径中任意一层为null，整个表达式就会返回空字符串。比如设备对象本身为null、嵌套的Device对象为null、applicationReports列表为null，这几种场景都会直接导致单元格空白，没有任何错误提示可排查。

可直接套用的正确代码写法 #

<!-- 外层遍历设备列表的基础结构 -->
<tr th:each="dev : ${myDeviceList}">
  <td th:text="${dev.customDeviceName}"></td>
  <td th:text="${dev.deviceStatus}"></td>
  <td th:text="${dev.hardwareModel}"></td>
  <td th:text="${dev.googleDeviceName}"></td>
  <td th:text="${dev.connectedPolicyName}"></td>
  <!-- 带空值保护的应用报告展示单元格 -->
  <td>
    <!-- 嵌套Device对象非空判断 -->
    <div th:if="${dev?.device != null}">
      <!-- 应用报告列表非空判断 -->
      <div th:if="${dev?.device?.applicationReports != null}">
        <div th:each="appReport : ${dev.device.applicationReports}"
             th:text="${appReport?.packageName}">
        </div>
        <!-- 列表为空时的兜底提示 -->
        <span th:if="${#lists.isEmpty(dev?.device?.applicationReports)}">暂无安装应用报告</span>
      </div>
    </div>
    <!-- 各层空值的兜底提示 -->
    <span th:if="${dev?.device == null}">谷歌侧设备信息同步中</span>
  </td>
</tr>

代码注意点：

• 所有嵌套层级的属性访问都加Thymeleaf的安全导航符?.，避免某层对象为null时整个表达式静默失败
• 如果发现序列化后字段名是下划线格式（比如application_reports、package_name），直接用方括号语法取值即可，比如${dev['device']['application_reports']}

快速定位问题的调试方法 #

• 逐层验证取值链路：可以临时在单元格内输出每层对象的内容，比如先写th:text="${dev.device}"，如果输出空白，说明MyDevice类的device属性本身没有传入有效内容；如果输出正常的Device对象序列化结果，再单独写th:text="${dev?.device?.applicationReports?.size()}"，如果返回null，说明问题出在后端API请求环节，和Thymeleaf语法无关。

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