解决MybatisPlus SqlServer OFFSET 分页问题

bangongJIAO1@c 发布于 2025-11-29 阅读(4)
目录
  • 问题
    • 错误源码重现
  • 找资料
    • 解决

      问题

      使用MybatisPlus 连接 SqlServer 数据库 ,在分页的时候发生了如下的报错,sql语句和报错如下:

      Cause: com.microsoft.sqlserver.jdbc.SQLServerException: “@P0”附近有语法错误。
      ...
      SQL: SELECT  * FROM tb_admin  OFFSET 0 ROWS FETCH NEXT 15 ROWS ONLY

      错误源码重现

      依赖

      		<!-- mybatis-plus -->
              <dependency>
                  <groupId>com.baomidou</groupId>
                  <artifactId>mybatis-plus-boot-starter</artifactId>
                  <version>3.4.1</version>
              </dependency>
              <!--        SqlServer依赖-->
              <dependency>
                  <groupId>com.microsoft.sqlserver</groupId>
                  <artifactId>mssql-jdbc</artifactId>
                  <scope>runtime</scope>
                  <version>7.4.1.jre8</version>
              </dependency>
      

      配置分页

      @Configuration
      public class MybatisPlusConfig {
          /**
           *   mybatis-plus分页插件
           */
          @Bean
          public MybatisPlusInterceptor mybatisPlusInterceptor() {
              MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
              interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.SQL_SERVER));
              return interceptor;
          }
      }
      

      分页处

      //开始分页
      IPage<Admin> pageInfo = new Page<Admin>().setCurrent(current).setSize(size);
      pageInfo = adminService.page(pageInfo, wrapper); //报错点
      

      找资料

      OFFSET 0 ROWS FETCH NEXT 15 ROWS ONLY 是SqlServer2012之后才有的
      关键字解析:

      • Offset子句:用于指定跳过(Skip)的数据行;
      • Fetch子句:该子句在Offset子句之后执行,表示在跳过(Sikp)指定数量的数据行之后,返回一定数据量的数据行;
      • 执行顺序:Offset子句必须在Order By 子句之后执行,Fetch子句必须在Offset子句之后执行;

      所以解决问题的关键是,加一个排序。

      至于为什么,我大致看了一下其他的解释,说得加一个唯一字段排序,否则系统排序结果不唯一?于是我随便试了一下order by 非唯一字段一样分页正常,这种说法说不通。
      如果有懂的,欢迎评论区留言

      解决

      在page之前,添加orderby字句

      //开始分页
      IPage<Admin> pageInfo = new Page<Admin>().setCurrent(current).setSize(size);
      wrapper.orderByDesc("id");
      pageInfo = adminService.page(pageInfo, wrapper); //报错点