MyBatisPlus最新版本中，如何正确配置和使用动态表名功能？

Question

**问题：如何在MyBatisPlus最新版本中动态切换表名以支持多表操作？** 在实际开发中，有时需要根据业务逻辑动态切换表名，例如按日期分表存储日志数据。MyBatisPlus 提供了 `MetaObjectHandler` 和自定义注解等方式，但更推荐使用 `TableField` 的动态替换功能或 SQL 片段实现。 具体步骤如下：首先，在实体类上不固定表名（避免使用 `@TableName` 注解），然后通过自定义 SQL 或全局配置拦截器（如 `AbstractRoutingDataSource`）动态注入表名。此外，可通过 MyBatis 的 `#{}` 占位符传递参数，结合 XML 配置完成动态拼接。 注意：动态表名需确保 SQL 安全性，防止注入风险；同时确认数据库连接权限与分表策略一致。若遇到表结构复杂场景，可配合 MyBatisPlus 的分页插件优化查询性能。

Answer 1

1. 问题背景与需求分析

在实际开发中，业务逻辑的复杂性往往要求我们对数据库表进行动态切换。例如，日志系统可能需要按照日期分表存储数据，以便于高效查询和管理。MyBatisPlus 提供了丰富的功能来支持这种场景。

具体来说，我们需要解决以下问题：

• 如何在实体类中避免固定表名？
• 如何通过自定义 SQL 或拦截器实现动态表名注入？
• 如何确保 SQL 安全性和性能优化？

接下来，我们将从基础到深入逐步探讨解决方案。

2. 基础方案：避免使用 @TableName 注解

在 MyBatisPlus 中，默认情况下可以通过 `@TableName` 注解指定实体类对应的数据库表名。然而，如果需要动态切换表名，则不能使用此注解。

例如，假设我们有一个日志实体类 `LogEntity`：

public class LogEntity {
        private Long id;
        private String content;
        private Date createTime;
        // getters and setters
    }

这里没有使用 `@TableName` 注解，因此 MyBatisPlus 不会自动映射到某个固定的表。

3. 进阶方案：通过自定义 SQL 实现动态表名

MyBatis 支持通过 `#{}` 占位符传递参数，结合 XML 配置可以实现动态表名拼接。以下是一个示例：

<select id="selectByDate" resultType="com.example.LogEntity">
        SELECT * FROM ${tableName} WHERE create_time = #{date}
    </select>

注意：这里使用 `${}` 而不是 `#{}`，因为 `${}` 会直接将参数值插入到 SQL 中，而 `#{}` 则会被视为绑定变量。

为了防止 SQL 注入风险，建议对 `tableName` 参数进行严格校验，确保其只包含合法字符。

4. 深入方案：使用拦截器实现全局动态表名

对于更复杂的场景，可以借助 MyBatis 的拦截器机制实现全局动态表名切换。以下是一个简单的拦截器实现：

@Intercepts({@Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class})})
public class DynamicTableNameInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        MappedStatement mappedStatement = (MappedStatement) invocation.getArgs()[0];
        Object parameter = invocation.getArgs()[1];
        BoundSql boundSql = mappedStatement.getBoundSql(parameter);
        String sql = boundSql.getSql();
        
        // 动态替换表名逻辑
        String newSql = sql.replace("log_table", getDynamicTableName());
        
        // 更新 SQL
        Field field = boundSql.getClass().getDeclaredField("sql");
        field.setAccessible(true);
        field.set(boundSql, newSql);
        
        return invocation.proceed();
    }
    
    private String getDynamicTableName() {
        // 根据业务逻辑生成动态表名
        return "log_" + LocalDate.now().toString();
    }
}

这个拦截器会在每次执行 SQL 时动态替换表名。你可以根据实际需求修改 `getDynamicTableName` 方法的逻辑。

5. 流程图：动态表名切换的整体流程

以下是动态表名切换的整体流程图：

sequenceDiagram
        participant Controller as 控制器
        participant Service as 服务层
        participant Mapper as 数据访问层
        participant Interceptor as 拦截器
        participant Database as 数据库
        Controller->>Service: 调用服务方法
        Service->>Mapper: 调用数据访问方法
        Mapper->>Interceptor: 触发拦截器
        Interceptor->>Interceptor: 动态替换表名
        Interceptor->>Database: 执行 SQL 查询

通过上述流程，我们可以清晰地看到动态表名切换的各个环节。

6. 注意事项与性能优化

在实现动态表名切换时，需要注意以下几点：

注意事项	解决方案
SQL 注入风险	对动态表名进行严格校验，确保其只包含合法字符。
数据库连接权限	确保数据库用户具有对所有相关表的访问权限。
分表策略一致性	制定统一的分表规则，并在代码中严格遵守。
查询性能优化	配合 MyBatisPlus 的分页插件，减少一次性查询的数据量。

以上注意事项可以帮助我们在实现动态表名切换时避免常见问题。