MyBatis下划线转驼峰配置详解

MyBatis 的 `mapUnderscoreToCamelCase` 配置看似简单，实则极易因使用场景理解偏差而“失效”——它仅对未显式定义映射关系的自动映射生效，一旦用了 `@ResultMap`、`@Column`、`@TableField` 或 XML 中的 ``（未设 `autoMapping="true"`），驼峰转换就会被绕过；Spring Boot 项目更需通过 `application.yml` 正确配置而非依赖 `mybatis-config.xml`，且必须避免手动覆盖 `SqlSessionFactoryBean` 的 configuration。真正掌握其生效边界（如自动映射 vs 手动绑定、注解优先级、XML 的 `autoMapping` 开关），才能让 `user_name` 稳定映射到 `userName`，告别字段为 null 的“玄学”问题。

为什么 mapUnderscoreToCamelCase 设了没用？

多数人配了 mapUnderscoreToCamelCase=true 却发现数据库字段 user_name 还是映射不到 Java 的 userName，根本原因不是配置写错，而是它只对「自动映射」生效——也就是没有显式写 、纯靠 MyBatis 自己猜列名和属性名时才起作用。

常见错误现象：User user = mapper.selectById(1); 返回的 user.userName 为 null，但 user.getUserName() 能取到值（说明 getter 被调用了，但字段没设上）。

• 只在 mybatis-config.xml 里配了，但 Spring Boot 项目实际走的是 MybatisAutoConfiguration，得改 application.yml 或 application.properties
• 用了 @Select 注解 + 自定义 SQL，但没加 resultType 或写了 resultMap，此时自动映射被跳过
• 实体类字段用了 @Column(name = "user_name") 或 @Results，显式覆盖了自动映射逻辑

Spring Boot 下正确开启全局驼峰转换

Spring Boot 2.0+ 默认不读 mybatis-config.xml，必须通过 Spring 配置项启用。核心是让 Configuration 实例的 mapUnderscoreToCamelCase 属性为 true，而 Spring Boot 的自动配置会把它从配置文件里拎出来设置。

• 在 application.yml 中写：

  mybatis:
    configuration:
      map-underscore-to-camel-case: true

• 如果用 application.properties：

  mybatis.configuration.map-underscore-to-camel-case=true

• 确认没在代码里手动 new SqlSessionFactoryBean 并覆盖 configuration 属性，否则外部配置会被忽略
• 该配置影响所有未显式指定 resultMap 的 select 语句，包括 @Select、XML 中的 <select> 和通用 Mapper 的方法

XML 中写了 还想用驼峰？别写全量映射

一旦 XML 里出现 ，MyBatis 就默认关闭自动映射，哪怕你只映射了一个字段，其他字段也不会再走驼峰转换。

解决办法不是删掉 ，而是用「自动映射 + 手动补充」模式：

• 给 加上 autoMapping="true" 属性：

  <resultMap id="UserResultMap" type="User" autoMapping="true">
    <id property="id" column="id"/>
    <!-- 其他字段如 user_name、create_time 会自动映射到 userName、createTime -->
  </resultMap>

• 确保 里的 property 名是驼峰，column 是下划线，不要反着写
• 避免混用：不要在同一个 里既写 autoMapping="true" 又把所有字段都手动 出来，那样等于白开

实体类字段加了 @TableField 或 @Column 会影响吗？

会，而且优先级更高。MyBatis-Plus 的 @TableField(value = "user_name") 或 JPA 的 @Column(name = "user_name") 会直接绑定列名到字段，绕过 mapUnderscoreToCamelCase 的转换逻辑。

• 如果你用了 MyBatis-Plus，且希望保留驼峰配置，就别给字段加 @TableField；加了就得显式写对 value，否则映射失败
• @TableField 的 exist = false 或 fill 等属性不会干扰映射，但 value 显式指定了列名，就不再走自动转换
• 纯 MyBatis（没集成 MP）不识别这些注解，所以它们只在对应框架下生效，别误以为是 MyBatis 原生行为

配置生效的关键不在“写没写”，而在“有没有被真正应用到当前 SQL 的映射流程里”。最常被忽略的是：显式 、注解绑定、以及 Spring Boot 下配置加载路径错位——这三处卡住，再对的参数也白搭。

今天关于《MyBatis下划线转驼峰配置详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！