<dependency>
    <groupId>io.github.osinn</groupId>
    <artifactId>druid-multi-tenant-starter</artifactId>
    <version>最新版本</version>
</dependency>

--基础配置 1.5.6版本开始 mybatis.tenant.config 改为 multi-tenant.config
multi-tenant:
  config:
    # 是否启用多租户插件
    enable: true
    # 数据库表租户ID的列名
    tenant-id-column: tenant_id
 
--完整配置参数   
multi-tenant:
  config:
    # 是否使用MyBatis拦截器方式修改sql
    enable: true
    # 数据库表租户ID的列名字段
    tenant-id-column: tenant_id
    # 数据库方言，可选，如果不指定会从事务数据元中自动识别获取方言类型
    db-type: mysql
    # SQL 拦截策略，默认 mybatis 拦截器，如果不是mybatis,且使用的是 DruidDataSource 数据源，推荐使用 druid_filter 过滤器策略
    # druid_filter 只支持使用 DruidDataSource 数据数据源连接数据库
    sql-interceptor-strategy: mybatis_interceptor
    # 是否启用切面方式忽略租户ID字段，默认不开启，开启后 @IgnoreTenantIdField 注解不仅仅可以使用在mybatis Mapper接口方法上，也可以使用在Service任意接口上
    enable-pointcut-advisor-ignore-tenant-id: false
    # 是否忽略表按租户ID过滤,默认所有表都按租户ID过滤，指定表名称(区分大小写全等判断)
    ignore-table-name:
     - user_role # 内部全等判断
    ignore-match-table-alias
    # 匹配判断指定表别名称是否忽略表按租户ID过滤(区分大小写匹配判断)
      - temp # 内部判断 以 temp 为前缀的别名进行忽略过滤
    # 根据表名前缀判断是否忽略表按租户ID过滤
    ignore-table-name-prefix: 
      - act_ # 内部判断 以 act_ 为前缀的别名进行忽略过滤
    # 多数据源情况下指定忽略跳过的数据源名称（需要重写ITenantService接口中的ignoreDynamicDatasource方法自行提供获取当前执行的数据源名称）
    ignore-dynamic-datasource:
      - demoDataSource # 内部全等判断
    # 数据源包装类型, 默认是 null
    #项目中存在 baomidou(苞米豆) 动态数据源，需要指定 baomidou_dynamic_data_source
    #
    # 项目中使用 sleuth 代理 jdbc 同时使用baomidou(苞米豆) 动态数据源，需要指定 sleuth_baomidou_dynamic_data_source_wrapper ，否则需要禁用 sleuth 中的 jdbc 代理
    # 如果项目中使用到 sleuth 同时使用baomidou(苞米豆) 动态数据源，应该禁用 sleuth 中的 jdbc 代理，例如以下配置，否则 sql-interceptor-strategy: druid_filter 是不会添加druid过滤器多租户 SQL 解析
    # spring:
    #   sleuth:
    #     jdbc:
    #       enabled: false
    data-source-wrapper-type: baomidou_dynamic_data_source
    # 是否自定义数据源，默认是 false，true时会调用addCustomDataSourceProxySqlParser()方法，用于自定义数据源添加SQL解析器
    enable-custom-data-source: false

/**
 * 演示：提供多租户ID服务接口
 * 
 * @author wency_cai
 * @since 1.5.6
 */
@Service
public class TenantServiceImpl extends TenantApplicationContext {
 
    @Override
    public List<Object> getTenantIds() {
        Long tenantId = 1L;
        List<Object> tenantIdList = new ArrayList<>();
        tenantIdList.add(tenantId);
        return tenantIdList;
    }
 
}

/**
 * 演示：提供多租户ID服务接口
 *
 * @author wency_cai
 * 
 * @since 1.5.6 开始需要继承 TenantApplicationContext 抽象类提供获取多租户ID值
 */
@Service
public class TenantServiceImpl extends TenantApplicationContext {
 
    @Override
    public List<Object> getTenantIds() {
        // 查询系统多租户id,如果有多个返回多个值即可
        int tenantId = 1;
        return Lists.newArrayList(tenantId);
    }
 
    // 如果需要指定某个数据源跳过设置租户ID，可以重写此方法，并且在yml配置文件中配置 ignore-dynamic-datasource 指定忽略的数据源名称
    @Override
    public String ignoreDynamicDatasource() {
        // 过去当前执行的数据源名称, 空则需要执行解析设置租户ID
        return 返回当前执行的数据源名称;
    }
 
    // 如果开发者需要自行解析SQL，可以重新此方法，并返回新的SQL语句，返回值为空时则继续执行默认解析逻辑，有返回值则直接返回且不会执行默认的解析逻辑
    @Override
    public String customizeParser(String originalSQL, Object paramTenantId) {
        return null;
    }
 
    // 如果开发者想要在执行默认的解析逻辑前做点什么，可以重写此方法，如果有返回值则会覆盖原始SQL语句（originalSQL）
    @Override
    public String before(String originalSQL, Object paramTenantId) {
        System.out.println("执行默认解析逻辑前 执行了 before方法");
        return null;
    }
 
    // 如果开发者想要在执行默认的解析逻辑后做点什么，可以重写此方法，如果有返回值则会覆盖解析后的SQL语句（newSQL）
    @Override
    public String after(String newSQL, Object paramTenantId) {
        System.out.println("执行默认解析逻辑后 执行了 after方法");
//        return newSQL + " and tenant_id = 123456";
        return null;
    }
 
    /**
     * 是否跳过解析，可以重写此方法，(实现当前线程全局判断是否忽略tenant_id字段)
     * 此方法可以用在此场景，如：init()方法下执行的所有sql语句忽略添加tenant_id字段，可以自行实现 ThreadLocal
     * 并在此方法中获取当前线程变量判断是否需要忽略添加tenant_id字段，如果需要忽略添加tenant_id字段，则返回true即可
     *
     * @return 返回 true 跳过解析, false 继续解析
     */
    @Override
    public boolean skipParser() {
        return false;
    }
 
    /**
     * 只有 yml 配置 enable-pointcut-advisor = true 时 内部会使用到 ThreadLocal
     * 流程: 调用 threadLocalSkipParserSet 方法 设置是否跳过解析 ——> skipParser 从 ThreadLocal 中获取设置值判断 ——> threadLocalSkipParserClear 清理上下文
     * 可以重写此方法实现使用自定义 ThreadLocal 实现，对应 调用 ThreadLocal 的 set 方法，即为 myThreadLocal.set(xxxx)
     * 如果不实现此方法，会调用内部默认的 ThreadLocal 实现
     * <p>
     * 需要注意的是，内部使用的 ThreadLocal 不支持跨线程调用(即 方法上使用@IgnoreTenantIdField 注解，此方法内又有异步方法，在异步方法内操作数据库，此时不会生效，依然会解析设置租户ID)
     * 如果需要支持跨线程(异步方法)，你的框架可参考使用 TransmittableThreadLocal 库创建线程池，然后实现 skipParser、threadLocalSkipParserSet、threadLocalSkipParserClear这三个方法逻辑
     *
     * @since 1.5.6
     */  
    @Override
    public void threadLocalSkipParserSet() {
        IGNORE_TENANT.set(Boolean.TRUE);
    }
 
    /**
     * 只有 yml 配置 enable-pointcut-advisor = true 时 内部会使用到 ThreadLocal
     * 可以重写此方法实现使用自定义 ThreadLocal 实现，对应 调用 ThreadLocal 的 clear 方法，即为 myThreadLocal.clear()
     * 如果不实现此方法，会调用内部默认的 ThreadLocal 实现
     *
     * @since 1.5.6
     */
    @Override
    public void threadLocalSkipParserClear() {
        IGNORE_TENANT.remove();
    }
 
    /**
     * 预留方法，当bean初始化后调用，自定义数据源添加代理 sql 解析器
     * yml 配置 enable-custom-data-source = true 时 才会调用此方法
     *
     * @param dataSource       数据源
     * @param defaultSqlParser sql 解析器
     * @return 如果需要自定义添加数据源代理 sql 解析器，则返回调整后的 dataSource 数据源,否则返回 null
     * @since 1.5.6
     */
    default Object addCustomDataSourceProxySqlParser(Object dataSource, DefaultSqlParser defaultSqlParser) {
 
        return null;
    }
}

public interface UserMapper {
 
    /**
     * 传入租户ID值，支持传入List或Set集合
     */
    User getUserInfoById(@Param("userId") Long userId, @Param("tenant_id") Long tenantId);
}

public interface UserMapper {
 
    /**
     * 添加@IgnoreTenantIdField注解来忽略设置多租户字段
     */
    @IgnoreTenantIdField
    void deleteTestIgnoreTenantIdById(Long id);
}

@Service
public class DemoService {
 
    @IgnoreTenantIdField
    public Role getRole() {
        return null;
    }
}
 
-- 需要开启 enable-pointcut-advisor-ignore-tenant-id，如下
multi-tenant:
  config:
    # 需要将此项配置设置为 true
    enable-pointcut-advisor-ignore-tenant-id: true

SELECT id, name, tenant_id
FROM role
WHERE tenant_id = 11
------------------------------------- 
 
SELECT *
FROM user s
WHERE s.name = '333'
  AND s.tenant_id = 11
------------------------------------- 
 
SELECT tenant_id
FROM people
WHERE id IN (
    SELECT id
    FROM user s
    WHERE s.tenant_id = 11
)
  AND tenant_id = 11
------------------------------------- 
 
SELECT tenant_id
FROM people
WHERE id IN (
    SELECT id
    FROM user s
    WHERE s.tenant_id = 11
)
  AND id IN (
    SELECT u.id
    FROM user u
    WHERE u.tenant_id = 11
)
  AND tenant_id = 11
------------------------------------- 
 
SELECT tenant_id
FROM people
WHERE id IN (
    SELECT id
    FROM user s
    WHERE s.tenant_id = 11
)
  AND id IN (
    SELECT u.id
    FROM user u
    WHERE u.tenant_id = 11
)
  AND tenant_id IN (
    SELECT u.tenant_id
    FROM user u
    WHERE u.tenant_id = 11
)
  AND tenant_id = 11
------------------------------------- 
 
SELECT p.tenant_id
     , (
    SELECT u.name
    FROM user u
    WHERE u.id = p.user_id
      AND u.tenant_id = 11
)
FROM people p
WHERE p.tenant_id = 11
------------------------------------- 
 
SELECT p.tenant_id
     , (
    SELECT u.name
    FROM user u
    WHERE u.id = p.user_id
      AND u.tenant_id = 11
)
     , (
    SELECT s.name
    FROM user s
    WHERE s.id = p.user_id
      AND s.tenant_id = 11
)
FROM people p
WHERE p.tenant_id = 11
------------------------------------- 
 
SELECT p.tenant_id
     , (
    SELECT u.name
         , (
        SELECT s.name
        FROM user s
        WHERE s.id = p.user_id
          AND s.tenant_id = 11
    )
    FROM user u
    WHERE u.id = p.user_id
      AND u.tenant_id = 11
)
FROM people p
WHERE p.tenant_id = 11
------------------------------------- 
 
SELECT u.*
FROM `user` u
         JOIN user_role ur
              ON ur.user_id = u.id
                  AND ur.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT u.*
FROM `user` u
         JOIN user_role ur
              ON ur.user_id = u.id
                  AND u.id = 22
                  AND ur.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT u.*
     , (
    SELECT ur.name
    FROM role r
    WHERE r.id = ur.role_id
      AND r.tenant_id = 11
) AS r_name
FROM `user` u
         JOIN user_role ur
              ON ur.user_id = u.id
                  AND u.id = 22
                  AND ur.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT u.*
FROM `user` u
         JOIN user_role ur
              ON ur.user_id = u.id
                  AND ur.role_id IN (
                      SELECT r.id
                      FROM role r
                      WHERE r.tenant_id = 11
                  )
                  AND ur.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT u.*
FROM `user` u
         JOIN user_role ur
              ON ur.user_id = u.id
                  AND ur.role_id IN (
                      SELECT r.id
                      FROM role r
                      WHERE r.tenant_id = 11
                  )
                  AND ur.test_id IN (
                      SELECT r.test_id
                      FROM role r
                      WHERE r.tenant_id = 11
                  )
                  AND ur.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT u.*
FROM `user` u
         LEFT JOIN user_role ur
                   ON ur.user_id = u.id
                       AND ur.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT u.*
FROM `user` u
         RIGHT JOIN user_role ur
                    ON ur.user_id = u.id
                        AND ur.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT COUNT(*), id
FROM `user`
WHERE tenant_id = 11
GROUP BY id
HAVING COUNT(*) >= 1
------------------------------------- 
 
SELECT EXISTS (
    SELECT *
    FROM `user`
    WHERE username = ?
      AND tenant_id = 11
) AS d
------------------------------------- 
 
SELECT EXISTS (
    SELECT tenant_id
    FROM people
    WHERE id IN (
        SELECT id
        FROM user s
        WHERE s.tenant_id = 11
    )
      AND tenant_id = 11
) AS d
------------------------------------- 
 
SELECT username
FROM `user`
WHERE tenant_id = 11
UNION
SELECT username
FROM account
WHERE tenant_id = 11
------------------------------------- 
 
SELECT u.*, r.id AS r_id, r.NAME AS r_name
FROM `user` u
         LEFT JOIN user_role ur
                   ON ur.user_id = u.id
                       AND ur.tenant_id = 11
         LEFT JOIN role r
                   ON r.id = ur.role_id
                       AND u.id = 22
                       AND r.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT u.*, r.id AS r_id, r.NAME AS r_name
FROM `user` u
         LEFT JOIN user_role ur
                   ON ur.user_id = u.id
                       AND ur.tenant_id = 11
         LEFT JOIN role r
                   ON r.id = ur.role_id
                       AND u.id = 22
                       AND r.tenant_id = 11
         LEFT JOIN menu m
                   ON m.role_id = r.id
                       AND m.tenant_id = 11
WHERE u.tenant_id = 11
------------------------------------- 
 
SELECT a, b
FROM (
         SELECT *
         FROM table_a
         WHERE tenant_id = 11
     ) temp
WHERE temp.a = 'a';
------------------------------------- 
 
SELECT temp.*
FROM (
         SELECT *
         FROM `user`
         WHERE tenant_id = 11
     ) temp
         JOIN user_role ur
              ON ur.user_id = temp.id
                  AND ur.tenant_id = 11
WHERE temp.a = 'a'
  AND temp.tenant_id = 11;
------------------------------------- 
 
SELECT id, name, tenant_id
FROM role
WHERE tenant_id = 1
  AND tenant_id = 11

UPDATE user u
SET ds = ?, u.name = ?, id = 'fdf', ddd = ?
WHERE id = ?
  AND u.tenant_id = 11
------------------------------------- 
 
UPDATE user u
SET ds = ?, u.name = ?, id = 'fdf', ddd = ?
WHERE id IN (1, 2, 3)
  AND u.tenant_id = 11
------------------------------------- 
 
UPDATE user u
SET ds = ?, u.name = ?, id = 'fdf', ddd = ?
WHERE id IN (
    SELECT ur.user_id
    FROM user_role ur
    WHERE ur.tenant_id = 11
)
  AND u.tenant_id = 11
------------------------------------- 
 
UPDATE user u
SET ds = ?, u.name = ?, id = 'fdf', ddd = ?
WHERE id IN (
    SELECT ur.user_id
    FROM user_role ur
    WHERE ur.id = 1
      AND ur.tenant_id = 11
)
  AND u.tenant_id = 11
------------------------------------- 
 
UPDATE `user` u
    JOIN user_role ur
ON ur.user_id = u.id
    AND u.id = 111
    AND ur.tenant_id = 11
    SET u.qr_code = '1212'
WHERE u.tenant_id = 11
------------------------------------- 
 
UPDATE `user` u
    JOIN user_role ur
ON ur.user_id = u.id
    AND u.id IN (
    SELECT urr.user_id
    FROM user_role urr
    WHERE urr.tenant_id = 11
    )
    AND ur.tenant_id = 11
    SET u.qr_code = '1212'
WHERE u.tenant_id = 11
------------------------------------- 
 
UPDATE user
SET name = CASE
               WHEN id = 1 THEN 'name1'
               WHEN id = 2 THEN 'name2'
               WHEN id = 3 THEN 'name3'
    END
WHERE id IN (11, 22, 33, 3)
  AND tenant_id = 11;

INSERT INTO `user` (`id`, `username`, `password`, tenant_id)
VALUES (?, ?, ?, 11),
       (?, ?, ?, 11),
       (?, ?, ?, 11)

DELETE FROM user
WHERE id = 1
  AND tenant_id = 11
------------------------------------- 
 
DELETE FROM user
WHERE id IN (
    SELECT id
    FROM user s
    WHERE s.tenant_id = 11
)
  AND tenant_id = 11
------------------------------------- 
 
DELETE FROM system_permission_data sp
    LEFT JOIN system_role_data_relation re
ON sp.id = re.data_id
    AND re.tenant_id = 11
    LEFT JOIN system_role sr
    ON sr.id = re.role_id
    AND sr.tenant_id = 11
WHERE sr.id = 1
  AND sp.tenant_id = 11