过滤Mybatis-plus全局多租户配置

写在前面

　　最近开发过程中，在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、net.sf.jsqlparser.parser.ParseException: Encountered unexpected token: "(" "("_drose29的博客-CSDN博客_net.sf.jsqlparser

2、mybatis plus 多租户 SQL 解析器_hlvy的博客-CSDN博客_mybatis plus sql解析器

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