Spring+Thymeleaf多Page对象渲染分页表报错咨询

你遇到的异常是因为Spring Data Thymeleaf Dialect默认会自动扫描Model中的Page对象，当存在多个Page实例时，无法确定使用哪一个，因此抛出冲突异常。完全可以在单个路由和视图中渲染3个不同的分页表格，不需要拆分路由，以下是两种可行方案：

方案一：手动指定分页组件的Page对象 #

在Controller中为每个Page对象设置唯一的属性名，然后在Thymeleaf的分页逻辑中明确指定要使用的Page实例，避免自动查找冲突。

1. Controller层代码 #

给每个Page对象分配独特的Model属性名，同时区分不同表格的分页参数（避免参数混淆）：

@GetMapping("/multi-table")
public String showMultiTables(
        // 为每个表格的分页参数添加前缀，避免冲突
        @RequestParam(value = "table1_page", defaultValue = "0") int table1Page,
        @RequestParam(value = "table1_size", defaultValue = "10") int table1Size,
        @RequestParam(value = "table2_page", defaultValue = "0") int table2Page,
        @RequestParam(value = "table2_size", defaultValue = "10") int table2Size,
        @RequestParam(value = "table3_page", defaultValue = "0") int table3Page,
        @RequestParam(value = "table3_size", defaultValue = "10") int table3Size,
        Model model) {
    
    // 构造各自的Pageable
    Pageable table1Pageable = PageRequest.of(table1Page, table1Size);
    Pageable table2Pageable = PageRequest.of(table2Page, table2Size);
    Pageable table3Pageable = PageRequest.of(table3Page, table3Size);
    
    // 查询数据并放入Model，使用唯一属性名
    Page<Order> orderPage = orderRepository.findAll(table1Pageable);
    Page<User> userPage = userRepository.findAll(table2Pageable);
    Page<Product> productPage = productRepository.findAll(table3Pageable);
    
    model.addAttribute("orderPage", orderPage);
    model.addAttribute("userPage", userPage);
    model.addAttribute("productPage", productPage);
    
    return "multi-table-view";
}

2. Thymeleaf视图代码 #

每个表格的分页逻辑中，明确引用对应的Page对象，并拼接专属的分页参数：

<!-- 第一个表格：订单列表 -->
<table>
    <thead>
        <tr>
            <th>订单ID</th>
            <th>订单金额</th>
        </tr>
    </thead>
    <tbody>
        <tr th:each="order : ${orderPage.content}">
            <td th:text="${order.id}"></td>
            <td th:text="${order.amount}"></td>
        </tr>
    </tbody>
</table>
<!-- 订单表格分页 -->
<div class="pagination">
    <a th:href="@{/multi-table(table1_page=${orderPage.number - 1}, table1_size=${orderPage.size}, table2_page=${userPage.number}, table2_size=${userPage.size}, table3_page=${productPage.number}, table3_size=${productPage.size})}" 
       th:disabled="${orderPage.first}">上一页</a>
       
    <span th:each="pageNum : ${#numbers.sequence(0, orderPage.totalPages - 1)}" 
          th:class="${pageNum == orderPage.number} ? 'active' : ''">
        <a th:href="@{/multi-table(table1_page=${pageNum}, table1_size=${orderPage.size}, table2_page=${userPage.number}, table2_size=${userPage.size}, table3_page=${productPage.number}, table3_size=${productPage.size})}">
            [[${pageNum + 1}]]
        </a>
    </span>
    
    <a th:href="@{/multi-table(table1_page=${orderPage.number + 1}, table1_size=${orderPage.size}, table2_page=${userPage.number}, table2_size=${userPage.size}, table3_page=${productPage.number}, table3_size=${productPage.size})}" 
       th:disabled="${orderPage.last}">下一页</a>
</div>

<!-- 第二个表格：用户列表（结构类似，替换为userPage） -->
<!-- 第三个表格：商品列表（结构类似，替换为productPage） -->

方案二：拆分为Thymeleaf片段 #

如果三个表格差异较大，拆分片段可以让代码更清晰，每个片段接收专属的Page参数，避免全局Model冲突。

1. 创建表格片段 #

比如创建fragments/order-table.html：

<div th:fragment="table(page)">
    <table>
        <!-- 订单表格内容 -->
        <tbody>
            <tr th:each="order : ${page.content}">
                <td th:text="${order.id}"></td>
                <td th:text="${order.amount}"></td>
            </tr>
        </tbody>
    </table>
    <!-- 订单分页逻辑，使用传入的page参数 -->
    <div class="pagination">
        <a th:href="@{/multi-table(table1_page=${page.number - 1}, table1_size=${page.size})}" th:disabled="${page.first}">上一页</a>
        <!-- 页码项省略 -->
    </div>
</div>

同理创建user-table.html和product-table.html片段。

2. 主视图引入片段 #

在主视图中分别传入对应的Page对象：

<!-- 引入订单表格片段 -->
<div th:replace="~{fragments/order-table :: table(page=${orderPage})}"></div>

<!-- 引入用户表格片段 -->
<div th:replace="~{fragments/user-table :: table(page=${userPage})}"></div>

<!-- 引入商品表格片段 -->
<div th:replace="~{fragments/product-table :: table(page=${productPage})}"></div>

总结 #

完全不需要拆分路由，单个视图即可渲染多个分页表格。两种方案中：

• 方案一适合不想拆分文件的场景，核心是避免自动查找Page对象，手动指定实例并区分分页参数；
• 方案二更适合表格逻辑复杂、差异大的场景，拆分片段后代码维护性更强。

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