解決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