MyBatis3 BaseMapper如何自动映射表名？

Question

在使用 MyBatis-Plus 的 BaseMapper 时，开发者常面临一个基础问题：如何实现实体类与数据库表的自动映射？BaseMapper 默认依据实体类名进行表名匹配，但实际开发中表名与类名往往存在差异，导致自动映射失败。这引出一个常见技术问题： **“在 MyBatis3 集成 MyBatis-Plus 的 BaseMapper 中，如何通过注解或配置实现表名自动映射？”** 具体表现为：实体类 User 对应的表名为 sys_user，而非默认的 user，如何让 BaseMapper 正确识别并映射表名？解决方案通常涉及使用 `@TableName` 注解或自定义配置策略。掌握这一机制是提升开发效率的关键。

Answer 1

一、MyBatis-Plus 中实体类与数据库表自动映射的基础概念

在使用 MyBatis-Plus 的 BaseMapper 时，开发者常常遇到实体类与数据库表名不一致的问题。默认情况下，BaseMapper 会根据实体类名推导出对应的表名，例如类名 User 会映射为表名 user。但在实际开发中，表名可能为 sys_user，此时默认的映射机制将失效。

解决该问题的核心在于理解 MyBatis-Plus 的自动映射机制以及其提供的扩展方式，包括使用注解和自定义配置策略。

二、使用 @TableName 注解实现表名映射

MyBatis-Plus 提供了 @TableName 注解，用于显式指定实体类对应的数据库表名。这是最直接、最常用的方式。

@Data
@TableName("sys_user")
public class User {
    private Long id;
    private String username;
    private String email;
}

• @TableName("sys_user") 告诉 MyBatis-Plus 该类映射的表名为 sys_user。
• 适用于单个类或少数几个类需要特殊处理的情况。

三、自定义配置策略实现全局表名映射

当项目中存在多个实体类与数据库表名命名规则一致但与类名不匹配时，使用全局配置策略更为高效。

可以通过配置 MyBatisPlusAutoConfiguration 或自定义 TableNameHandler 实现自动映射逻辑。

@Configuration
public class MyBatisPlusConfig {

    @Bean
    public MyBatisPlusInterceptor myBatisPlusInterceptor() {
        return new MyBatisPlusInterceptor();
    }

    @Bean
    public TableNameHandler tableNameHandler() {
        return (sql, mappedStatement, boundSql) -> {
            String entityName = mappedStatement.getId().split("\\.")[1];
            return "sys_" + entityName.toLowerCase();
        };
    }
}

1. 上述配置中，tableNameHandler 方法定义了将类名转换为 sys_* 表名的逻辑。
2. 适用于多个实体类命名统一、需统一映射规则的场景。

四、MyBatis-Plus 表名映射机制解析流程图

graph TD
    A[启动 MyBatis-Plus] --> B{是否配置@TableName注解?}
    B -->|是| C[使用注解指定的表名]
    B -->|否| D{是否配置全局TableNameHandler?}
    D -->|是| E[使用全局策略生成表名]
    D -->|否| F[使用默认类名转小写作为表名]
    C --> G[完成映射]
    E --> G
    F --> G

五、不同场景下的映射策略对比

策略类型	适用场景	优点	缺点
@TableName 注解	单个或少量类需要映射	简单、直观、易于维护	不适用于大量类
自定义 TableNameHandler	多个类遵循统一命名规则	统一管理、减少冗余配置	逻辑复杂时维护成本高
MyBatis XML 映射文件	需要完全自定义 SQL 的情况	灵活、控制粒度细	失去自动映射优势，开发效率低

六、高级扩展：结合 Spring Boot 自动装配实现动态映射

在 Spring Boot 项目中，可通过自定义 AutoConfiguration 类动态注入映射策略，结合 Environment 或 Properties 文件实现灵活配置。

@Component
public class DynamicTableNameHandler implements TableNameHandler {

    @Value("${mybatis-plus.table-prefix}")
    private String prefix;

    @Override
    public String dynamicTableName(String sql, MappedStatement mappedStatement, BoundSql boundSql) {
        String entityName = mappedStatement.getId().split("\\.")[1];
        return prefix + entityName.toLowerCase();
    }
}

• 通过 application.properties 配置前缀，如 mybatis-plus.table-prefix=sys_。
• 适用于多环境（开发、测试、生产）表名策略不同的场景。