解决mybatis-plus排序异常：failed to concat orderBy from IPage, exception=null

解决方案

String sql = "xxx"; // 放入不能正常进行排序的SQL语句
CCJSqlParserUtil.parse(sql); // 调用该方法，查看报错信息

1. 根据parse方法执行时所抛出的异常信息中的line和column，定位出SQL语句中有问题的那一块代码，然后进行修正
2. 将修正过后的SQL语句放入mapper中

注意，不要只看line和column给出位置的代码，要把其位置左右两边的代码也进行排查。

---

问题复现

pom.xml

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.8.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
	<java.version>1.8</java.version>
</properties>
<dependencies>
	...
	<!-- mysql -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
        <version>5.1.48</version>
    </dependency>

    <!-- mybatis -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.2.0</version>
    </dependency>
	...
</dependencies>

service层

Page<UserVO> page = new Page<>(pageNum, pageSize); // 构建分页对象
page.setOrders(List<OrderItem>); // 设入排序项
userMapper.selectList(page); // 调用mybatis进行查询

dao层

IPage<UserVO> selectList(page);

mapper

<mapper>
	<select id="selectList" resultType="com.demo.springboottest.vo.UserVO">
		SELECT CONCAT(u.id, '/', u.group) AS groups FROM `user` u
	</select>
</mapper>

执行selectList方法后，控制台出现：
failed to concat orderBy from IPage, exception=null
返回结果数据也没有按预期进行排序

排查过程

• 根据控制台出现的报错信息，搜索引入的mybatis-plus jar包
• 在这些jar包中搜索failed to concat orderBy from IPage, exception信息
• 定位到mybatis-plus-extension-3.2.0.jar中com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor类的concatOrderBy方法

调试过程

• 对concatOrderBy方法的执行过程进行debug，得知在调用CCJSqlParserUtil的parse方法对sql语句进行解析时抛出了JSQLParserException异常
• concatOrderBy方法对上述异常进行捕获，并打印日志信息: failed to concat orderBy from IPage, exception

解决过程

• 对SQL进行修改，手动调用CCJSqlParserUtil的parse方法对修改后的语句进行调试
• 调试没问题后，将修正过的SQL语句放入mapper文件中

修正过后的SQL语句

SELECT CONCAT(u.id, '/', u.`group`) AS groups FROM `user` u