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.4.0以下版本可以直接 添加此注解 即可,3.1.1以下版本需要添加如下配置:

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

mybatis-plus3.4.0及以上版本注意: 

@SqlParser(filter = true) 在mybatis-plus最新版本3.4.0及以上版本中被标记为已过时,具体替代方案,官网已给出(https://baomidou.com/guide/interceptor.html#mybatisplusinterceptor)。

官网替代注解如下:

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
public @interface InterceptorIgnore {
    ...
}

关于此注解官网给出如下使用方法:

鉴于此,如果项目引入的MybatisPlus版本为3.4.0及以上,针对多租户屏蔽某个特定mapper接口的方法,可以使用如下解决方案:

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

参考文档:

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

posted @ 2020-07-01 11:35  星空流年  阅读(30666)  评论(1编辑  收藏  举报