解决了一个关于ruoyi-vue添加租户id的拦截问题

## 问题描述

> 在手上目前负责的一个ruoyi-vue-pro的项目中，需要增加 租户id的拦截，也就是使用mybatis-plus的租户拦截功能，在所有的sql语句后面拼接tenant_id = xxx的功能。

代码很简单：主要有以下几段：

租户id的拦截器，从header头里拿到 Tenant-Id的值

```java
@Component
public class TenantIdInterceptor implements HandlerInterceptor {

@Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        String tenantId = request.getHeader("Tenant-Id");

// 手动判断：不为 null，且去除空格后长度大于 0
        if (tenantId != null && !tenantId.trim().isEmpty()) {
            TenantContextHolder.setTenantId(tenantId);
            return true;
        } else {
            throw new RuntimeException("Missing required header: 'tenant-id'");
        }
    }

@Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        // 关键：必须清理，避免线程池中线程复用导致租户污染
        TenantContextHolder.clear();
    }
}
```

TenantContextHolder 是一个典型的 上下文持有者（Context Holder）

```java
public class TenantContextHolder {
    private static final ThreadLocal<String> CONTEXT = new TransmittableThreadLocal<>();

public static void setTenantId(String tenantId) {
        CONTEXT.set(tenantId);
    }

public static String getTenantId() {
        return CONTEXT.get();
    }

public static void clear() {
        CONTEXT.remove(); // 防止内存泄漏
    }
}
```

配置类 MybatisPlusConfig，通过这个配置类，将我们的MybatisPlusInterceptor 托管给spring进行管理。

```java
@Configuration
public class MybatisPlusConfig {

@Autowired
    private ApplicationContext applicationContext;

@PostConstruct
    public void init() {
        System.out.println("🔥🔥🔥 MybatisPlusConfig 被 Spring 初始化了！！！");
        System.out.println("💡 当前 Spring 容器: " + applicationContext.getId());
    }

static {
        System.out.println("📦 类位置: " +
                MybatisPlusConfig.class.getResource("/" +
                        MybatisPlusConfig.class.getName().replace(".", "/") + ".class"));

System.out.println("🔍 类加载器: " + MybatisPlusConfig.class.getClassLoader());
        System.out.println("🧩 类加载器类型: " + MybatisPlusConfig.class.getClassLoader().getClass().getName());
    }

@Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {

System.out.println("✅✅✅ 正在创建 MybatisPlusInterceptor Bean！！！");
        
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();

TenantLineInnerInterceptor tenantInterceptor = new TenantLineInnerInterceptor(new TenantLineHandler() {
            @Override
            public Expression getTenantId() {
                // 关键：这里从 ThreadLocal 中获取 tenant_id
                return new StringValue("1082"); // TenantContextHolder.getTenantId()
            }

// 指定哪些表需要拼接 tenant_id
            @Override
            public String getTenantIdColumn() {
                return "tenant_id"; // 默认字段名
            }

@Override
            public boolean ignoreTable(String tableName) {
                // 系统表、用户表等不需要多租户隔离的表
                return "sys_user".equalsIgnoreCase(tableName) ||
                        "sys_dept".equalsIgnoreCase(tableName);
            }
        });

interceptor.addInnerInterceptor(tenantInterceptor);
        return interceptor;
    }
}
```

在这个里面添加 TenantIdInterceptor的拦截，用于 拦截所有http请求，拿到header里的tenant_id

```java
@Configuration
public class MvcConfig implements WebMvcConfigurer {

@Resource
    private AuthorizationInterceptor authorizationInterceptor;

@Resource
    private TenantIdInterceptor tenantIdInterceptor;

@Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(authorizationInterceptor);

// 多租户拦截器
        registry.addInterceptor(tenantIdInterceptor);
    }

}

```

上面的代码， 在我的mybatis-plus-demo的工程中可以正常运行，但是在我的公司的项目上，也就是ruoyi-vue-pro的项目里 死活 拦截不了tenant_id,
跟大模型对话了一个多小时，排查的原因包括：
mapperScan
scanBasePackages
Configuration 拼写问题
@Bean 方法是 static 或 private 签名问题
类被 final 修饰
条件注解导致跳过
@Import(MybatisPlusConfig.class) 强制导入

全都不行，，

最后我通过在启动类里添加：

```java
 @Autowired
 private ApplicationContext applicationContext;

@Bean
public CommandLineRunner checkMybatisPlusInterceptor() {
    return args -> {
        String[] names = applicationContext.getBeanNamesForType(MybatisPlusInterceptor.class);
        if (names.length > 0) {
            System.out.println("🔴 已存在的 MybatisPlusInterceptor Bean:");
            for (String name : names) {
                System.out.println("   - " + name + " (来自: " + applicationContext.getType(name).getName() + ")");
            }
        } else {
            System.out.println("🟢 未发现 MybatisPlusInterceptor Bean，你的 @Bean 应该会被创建");
        }
    };
}
```
打印的结果是：
~~~
🔴 已存在的 MybatisPlusInterceptor Bean:
   - mybatisPlusInterceptor (来自: com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor)
~~~

大模型瞬间明白了。。。

🔥 根本原因：MyBatis Plus 的自动配置已经创建了 MybatisPlusInterceptor Bean
Spring Boot 的 mybatis-plus-boot-starter 会自动配置：

```java
@Configuration
@ConditionalOnClass(MybatisPlusInterceptor.class)
public class MybatisPlusAutoConfiguration {

@Bean
    @ConditionalOnMissingBean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        return new MybatisPlusInterceptor(); // 空的！没有插件！
    }
}
```
👉 它创建了一个 空的 MybatisPlusInterceptor 实例，但没有添加任何插件（分页、多租户等）。

导致下面我写的代码永远都不会执行 ：
~~~
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    // 这个方法根本不会执行！
    // 因为上面那个自动配置已经创建了同类型的 Bean
}
~~~

为什么 demo 项目可以？
因为 demo 项目可能：没引入 mybatis-plus-boot-starter

## 解决方法：

第一种：修改MybatisPlusConfig

```java
@Configuration
public class MybatisPlusConfig {

@Autowired
    private MybatisPlusInterceptor mybatisPlusInterceptor;

@PostConstruct
    public void addTenantPlugin() {
        System.out.println("向已有的 MybatisPlusInterceptor 添加 Tenant 插件");

TenantLineInnerInterceptor tenantInterceptor = new TenantLineInnerInterceptor(new TenantLineHandler() {
            @Override
            public Expression getTenantId() {
                return new StringValue(TenantContextHolder.getTenantId());
            }

@Override
            public String getTenantIdColumn() {
                return "tenant_id";
            }

@Override
            public boolean ignoreTable(String tableName) {
                return "sys_user".equalsIgnoreCase(tableName) ||
                        "sys_dept".equalsIgnoreCase(tableName);
            }
        });

// 添加到拦截器链
        mybatisPlusInterceptor.addInnerInterceptor(tenantInterceptor);
    }
    
}
```

第二种方法：
在 @Bean上面添加一个 @Primary，但是我验证后的结果 是：不行！！
~~~

@Primary
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    // ...
}

~~~

🔍 为什么 @Primary 不行？
✅ @Primary 的作用是：
> 当 存在多个同类型 Bean 时，告诉 Spring：“选我作为默认注入的那一个”。

❌ 但它不能解决的问题是：
> @ConditionalOnMissingBean 导致你的 @Bean 方法根本不会被执行！

🧠 关键逻辑梳理

mybatis-plus-boot-starter 的自动配置类：
~~~
@Bean
@ConditionalOnMissingBean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    return new MybatisPlusInterceptor(); // 先创建了！
}
~~~
* Spring 处理到你的配置类时：
	发现：已经存在一个 MybatisPlusInterceptor 类型的 Bean
	所以：跳过你的 @Bean 方法（因为 @ConditionalOnMissingBean 生效）
	结果：你的方法压根没执行，更别提 @Primary 了
	
👉 @Primary 还没登场，你的 Bean 就已经被“消灭”在摇篮里了。

✅ 类比理解
想象一场“Bean 选拔赛”：

规则：只允许一个 MybatisPlusInterceptor 参赛（@ConditionalOnMissingBean）
	自动配置的 Bean 先报名，成功入选
	你的 Bean 来晚了，裁判说：“名额已满，你不能参赛”
	你说：“但我有 @Primary 金牌！”
	裁判：“不好意思，你连赛场都没进，金牌没用”

> 在 Spring 的世界里，@ConditionalOnMissingBean 决定你能不能进场，@Primary 决定你进场后坐第几排。

哈哈哈哈，，通义大模型真能白话。。。