MyBatisPlus 与 Thymeleaf 全栈分页实战

示例表结构

我们以城市停水信息数据为例，重点展示数据的分页展示逻辑。基础表结构包含主键、区域、时间等字段，具体设计如下：

对应的实例数据预览：

Java 后台分页实现

实体类定义

实体类直接映射数据库表，利用 Lombok 简化 Getter/Setter 生成。注意注解中的字段映射关系，确保驼峰命名与下划线列名正确对应。

package org.yelang.pcwater.domain;

import java.io.Serializable;
import java.util.Date;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.google.gson.annotations.SerializedName;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;

/**
 * - 停水信息表，用于同步停水数据
 */
@TableName(value = "biz_stop_water_info")
@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString
public class StopWaterInfo implements Serializable {
    private static final long serialVersionUID = -1582687729349525826L;

    @TableId(value="pk_id")
    private Long pkId;

    @TableField(value = "affect_user")
    private String affectUser; // 停水客户

    @TableField(value = "affected_range")
    private String affectedRange; // 停水范围

    @TableField(value = "affect_region")
    private String affectRegion; // 停水区域

    @TableField(value = "created_on")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date createdOn; // 原创建时间

    @TableField(value = "inform_emergency_plan")
    private String informEmergencyPlan; // 应急计划

    @TableField(value = "inform_id")
    private Integer informId; // 信息标识

    @TableField(value = "inform_remark")
    private String informRemark; // 备注信息

    @TableField(value = "main_lead_path")
    private String mainLeadPath; // 停水主管径

    private String position; // 停水地点
    private String reason; // 停水原因

    @TableField(value = "service_phone")
    private String servicePhone; // 服务热线

    @TableField(value = "show_end_date")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @SerializedName("showenddate")
    private Date showEndDate; // 显示结束时间

    @TableField(value = "stop_end_time")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date stopEndTime; // 停水结束时间

    @TableField(value = "stop_start_time")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date stopStartTime; // 停水开始时间

    @TableField(value = "stop_time")
    @SerializedName("stoptime")
    private String stopTime; // 停水时间

    @TableField(value = "stopwater_type")
    private String stopwaterType; // 停水类型

    @TableField(value = "supply_emergency_plan")
    private String supplyEmergencyPlan; // 应急供应计划

    @TableField(value = "supply_remark")
    private String supplyRemark; // 供应备注

    private String title; // 停水标题
    private String type; // 类型

    @TableField(value = "regin_name")
    private String reginName; // 区域名称

    @TableField(value = "sync_sno")
    private Long syncSno; // 同步批次号
}

业务层分页逻辑

分页的核心在于 IPage 对象的使用。我们在 Service 接口定义分页方法，并在实现类中构造 QueryWrapper 和 Page 对象。

接口定义：

/**
 * -根据区域查询分页停水信息列表
 * @param pageNum
 * @param pageSize
 * @param regionName
 * @return
 */
IPage<StopWaterInfo> page(Integer pageNum, Integer pageSize, String regionName);

实现逻辑：

@Override
public IPage<StopWaterInfo> page(Integer pageNum, Integer pageSize, String regionName) {
    QueryWrapper<StopWaterInfo> queryWrapper = new QueryWrapper<>();
    queryWrapper.like("regin_name", regionName);
    queryWrapper.orderByDesc("created_on");
    
    Page<StopWaterInfo> page = new Page<>(pageNum, pageSize);
    return this.baseMapper.selectPage(page, queryWrapper);
}

这里通过构造 Page 对象，将控制层传入的当前页码和每页大小一起传入，配合 QueryWrapper 进行条件过滤和排序，最后调用 selectPage 完成查询。

控制层 API

Controller 接收前端参数，调用 Service 后返回封装好的结果。注意参数默认值的设置，避免空指针异常。

/**
 * - 获取分页数据
 * @param pageNum
 * @param pageSize
 * @param regionName
 * @return
 */
@PostMapping("/list")
@ResponseBody
public AjaxResult list(@RequestParam(defaultValue = "1") Integer pageNum,
                       @RequestParam(defaultValue = "5") Integer pageSize,
                       @RequestParam(defaultValue = "") String regionName) {
    IPage<StopWaterInfo> page = waterInfoService.page(pageNum, pageSize, regionName);
    AjaxResult result = AjaxResult.success();
    result.put("data", page);
    return result;
}

Thymeleaf 分页集成

Thymeleaf 作为现代 Java 模板引擎，能很好地与 Spring Boot 集成。虽然本例主要演示 Ajax 动态渲染，但理解其表达式绑定对后续静态页面开发很有帮助。

分页表格展示

HTML 结构中预留表格主体，利用 JavaScript 从后端获取数据并动态填充。

<div>
    <table>
        <thead>
            <tr>
                <th>创建时间</th>
                <th>停水地点</th>
                <th>原因</th>
            </tr>
        </thead>
        <tbody id="table-body">
            <!-- 初始状态或空状态提示 -->
        </tbody>
    </table>
</div>

JavaScript 负责发起 Ajax 请求并渲染表格：

function renderTablePage(page) {
    currentPage = page;
    const tableBody = document.getElementById('table-body');
    tableBody.innerHTML = '';
    
    $.ajax({
        type: "post",
        url: ctx + "datasync/list",
        dataType: "json",
        cache: false,
        processData: true,
        data: {"pageNum": page, "pageSize": EVENTS_PER_PAGE, "regionName": ""},
        success: function(result) {
            const pageData = result.data.records;
            const totalPages = result.data.pages;
            
            if (pageData.length === 0) {
                tableBody.innerHTML = `<tr><td colspan="5">未找到符合条件的停水事件。</td></tr>`;
            } else {
                pageData.forEach(event => {
                    const row = tableBody.insertRow();
                    row.innerHTML = `
                        <td>${event.createdOn}</td>
                        <td>${event.position}</td>
                        <td>${event.reason}</td>
                    `;
                });
            }
            renderPagination(totalPages);
        },
        error: function() {
            tableBody.innerHTML = `<tr><td colspan="5">未找到符合条件的停水事件。</td></tr>`;
        }
    });
}

拿到响应后，遍历 records 动态拼接行，同时触发分页条渲染。

分页条集成

分页条通常位于表格下方，提供上一页、下一页跳转功能。

HTML 容器：

<div>
    <nav aria-label="Table Pagination">
        <ul id="table-pagination"></ul>
    </nav>
</div>

JS 逻辑：

function renderPagination(totalPages) {
    const paginationContainer = document.getElementById('table-pagination');
    paginationContainer.innerHTML = '';
    
    if (totalPages <= 1) return;
    
    // 上一页
    paginationContainer.innerHTML += `
        <li ${currentPage === 1 ? 'disabled' : ''}>
            <a href="#" onclick="changePage(${totalPages},${currentPage - 1})" aria-label="Previous">前一页</a>
        </li>
    `;
    
    // 下一页
    paginationContainer.innerHTML += `
        <li ${currentPage === totalPages ? 'disabled' : ''}>
            <a href="#" onclick="changePage(${totalPages},${currentPage + 1})" aria-label="Next">后一页</a>
        </li>
    `;
}

注意修复了原代码中 <li> 标签属性语法错误，确保禁用状态能正确显示。

最终效果如下：

可能遇到的问题

分页不展示

如果在页面上看到数据全部加载且无分页条，通常是后端分页插件未生效。此时 IPage 对象中的 pages 字段可能为 1，导致前端认为只有一页。

排查截图：

解决方案

检查是否配置了 MybatisPlusInterceptor 并添加了 PaginationInnerInterceptor。这是 MyBatisPlus 拦截 SQL 执行的关键组件。

配置类：

package org.yelang.pcwater.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;

/**
 * - mybatis 分页组件
 */
@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor i = new MybatisPlusInterceptor();
        i.addInnerInterceptor(new PaginationInnerInterceptor(DbType.POSTGRE_SQL));
        return i;
    }
}

配置完成后重启服务，分页条即可正常显示。

总结

本文演示了从后端实体定义、Service 分页逻辑到前端 Ajax 渲染的全流程。核心在于 MyBatisPlus 的 IPage 对象与前端 JS 的无缝对接。只要分页插件配置正确，基本就能解决大部分分页失效问题。这套方案适用于大多数传统 Web 项目场景，开发者可根据实际业务需求扩展更多交互细节。