MyBatis-Plus 租户插件在 EXISTS 语句中的使用问题分析

问题背景

MyBatis-Plus 作为 MyBatis 的增强工具，提供了许多便捷功能，其中租户插件是多租户架构中的重要组成部分。租户插件通过自动在 SQL 语句中添加租户条件（如 tenant_id = xxx）来实现数据隔离。然而，在实际使用中，开发者发现当 SQL 语句中包含 EXISTS 子查询时，租户条件未能正确添加到子查询中。

问题现象

通过对比两个相似的查询语句，我们可以清晰地看到问题所在：

1. 普通 SELECT 查询：

@Select("select 1 from user userT where idNo = #{loginAccount} limit 1")
Integer test1(String loginAccount);

生成的 SQL 正确添加了租户条件：

SELECT 1 FROM user userT WHERE idNo = ? AND userT.tenantId = 0 LIMIT 1

2. EXISTS 子查询：

@Select("select exists(select 1 from user userT where idNo = #{loginAccount} limit 1)")
Boolean test2(String loginAccount);

生成的 SQL 中 EXISTS 子查询缺少租户条件：

SELECT EXISTS (SELECT 1 FROM user userT WHERE idNo = ? LIMIT 1)

技术分析

租户插件工作原理

MyBatis-Plus 租户插件通过拦截 SQL 语句并解析其语法树，在适当的位置插入租户条件。它主要处理以下几种情况：

1. 普通表查询
2. 表连接查询
3. 子查询

EXISTS 语句的特殊性

EXISTS 子查询在 SQL 解析中有其特殊性：

1. EXISTS 是一个谓词，返回布尔值
2. 子查询中的表引用与外部查询是独立的
3. 传统 SQL 解析器可能将 EXISTS 子查询视为一个整体处理

问题根源

在 MyBatis-Plus 3.5.5 和 3.5.6 版本中，租户插件对 EXISTS 子查询的处理存在以下问题：

1. 插件未能正确识别 EXISTS 子查询中的表引用
2. 条件注入逻辑没有覆盖到子查询内部
3. 语法树解析时可能跳过了 EXISTS 子查询的内部结构

解决方案

该问题已在 MyBatis-Plus 3.5.7-SNAPSHOT 版本中修复。开发者可以通过以下方式解决：

1. 升级到 3.5.7 或更高版本
2. 如果暂时无法升级，可以考虑以下临时方案：
   • 重写 SQL，将 EXISTS 改为 JOIN 查询
   • 手动添加租户条件到 EXISTS 子查询中

最佳实践

在使用 MyBatis-Plus 租户插件时，建议：

1. 全面测试各种复杂查询场景
2. 特别注意子查询、EXISTS、IN 等特殊语法
3. 保持 MyBatis-Plus 版本更新
4. 对于关键业务查询，建议进行 SQL 日志审查

总结

多租户架构中的数据隔离是系统安全的重要保障。MyBatis-Plus 租户插件虽然强大，但在处理某些特殊 SQL 结构时可能存在不足。开发者需要了解这些边界情况，并在实际使用中进行充分验证，确保数据隔离的完整性。