MyBatis-Plus 数据库字段名与实体类属性名映射问题解析

问题背景

在使用 MyBatis-Plus 进行开发时，开发者可能会遇到数据库字段名与实体类属性名映射不一致的问题。具体表现为：数据库表字段采用驼峰命名法（如 loginName），但在执行查询时，MyBatis-Plus 自动生成的 SQL 语句却将字段名转换为下划线格式（如 login_name），导致 SQL 执行失败。

问题原因分析

MyBatis-Plus 默认启用了字段名策略转换功能，这是为了兼容不同数据库的命名规范。默认情况下，MyBatis-Plus 会将 Java 实体类的驼峰命名属性自动转换为数据库的下划线命名格式。这种设计虽然符合大多数 Java 开发者的习惯，但在某些特殊场景下（如数据库字段本身就是驼峰命名）反而会造成问题。

解决方案

方案一：启用表字段注解

在实体类生成配置中，添加 enableTableFieldAnnotation() 配置：

new AutoGenerator().setGlobalConfig(builder -> {
    builder.enableTableFieldAnnotation();
});

这种方法会为每个字段生成 @TableField 注解，明确指定数据库字段名，避免自动转换。

方案二：修改命名策略

通过配置命名策略为 NamingStrategy.no_change，可以禁用自动转换功能：

new AutoGenerator().setStrategy(new StrategyConfig.Builder()
    .entityBuilder()
    .columnNaming(NamingStrategy.no_change)
    .build());

这种方式会保持数据库字段名与实体类属性名完全一致，不做任何转换。

深入理解

MyBatis-Plus 的字段名映射机制实际上包含两个层面：

1. 代码生成层面：通过代码生成器配置决定是否生成 @TableField 注解以及如何处理命名转换
2. 运行时层面：MyBatis-Plus 核心会根据实体类配置决定如何构建 SQL 语句

当两种层面的配置不一致时，就可能出现上述问题。因此，开发者需要确保代码生成配置与运行时需求保持一致。

最佳实践建议

1. 对于新项目，建议统一数据库命名规范（推荐下划线命名法）
2. 对于已有系统改造，根据实际情况选择上述解决方案
3. 在团队开发中，应在项目文档中明确命名转换策略
4. 对于混合命名风格的数据库，推荐使用 @TableField 注解显式指定字段名

总结

MyBatis-Plus 的字段名自动转换功能虽然方便，但在特殊场景下需要开发者手动干预。理解其背后的工作机制，合理配置命名策略，可以避免类似问题的发生，提高开发效率。