SpringBoot项目：net.sf.jsqlparser.parser.ParseException: Encountered unexpected token:XXXXX

写在前面

　　最近开发过程中，在where条件中使用IF函数，在MySQL数据库中，使用Navicat运行没有问题，但是运行项目的时候，死活过不去，一直报错，后来一番折腾找到了解决方案，所以，以防后续再出现类似问题，仅做记录！

说明：项目为SpringBoot项目，持久化层框架使用的是Mybatis-plus(版本为3.0.7)

1、问题复现

1.1 SQL语句执行结果

1.2 Mapper层对应的接口

1.3 Mybatis对应的xml文件代码

 1.4 报错信息

 2、问题原因

　　针对这个问题，在网上查了相关文档，Mybatis-plus官网说是框架中使用到了多租户功能，Mybatis-plus 会 进行数据权限的过滤，但是有些接口，其实并不想被多租户过滤，所以要对该条sql，进行租户放行。关于这块Mybatis-plus官网说明了 SqlParserFilter  sql 解析过滤器，当然对这部分感兴趣的小伙伴们，可以去Mybatis-plus官网查看相关源码，我这里就不在具体说明了。

说明：多租户：多个用户间使用同一套程序，但每个用户之间实现数据隔离

3、问题解决

　　参考Mybatis-plus官网，在Mapper层接口方法上 加入注解  

@SqlParser(filter=true)

官网截图如下：

加完注解之后的Mapper层接口方法如下：

@SqlParser(filter = true)
List<EmpWhiteList> getAdminList(@Param("empId") String empId, @Param("timeDate") String timeDate);

加完次注解之后，由于项目的Mybatis-plus版本为3.0.7，所以这里还要再在application.yml文件中添加下列配置才能生效

说明：如果Mybatis-plus版本是3.1.1以上的  直接 添加此注解 即可，3.1.1以下版本需要添加如下配置：

# 开启 SQL 解析缓存注解生效
mybatis-plus:
  global-config:
    sql-parser-cache: true

参考文档：

1、https://blog.csdn.net/drose29/article/details/103893228

2、https://blog.csdn.net/qq_39313596/article/details/100943090

3、https://mp.baomidou.com/guide/tenant.html