mapUnderscoreToCamelCase只对自动映射生效，即未定义resultMap、未用@Column/@TableField显式绑定、未在@Select中指定resultMap时才起作用；Spring Boot需在application.yml中配置mybatis.configuration.map-underscore-to-camel-case:true，且resultMap须设autoMapping="true"才能兼顾手动与自动映射。
为什么 mapUnderscoreToCamelCase 设了没用？
多数人配了 mapUnderscoreToCamelCase=true 却发现数据库字段 user_name 还是映射不到 Java 的 userName，根本原因不是配置写错，而是它只对「自动映射」生效——也就是没有显式写 <resultMap>、纯靠 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 中写了 <resultMap> 还想用驼峰？别写全量映射
一旦 XML 里出现 <resultMap id="xxx">，MyBatis 就默认关闭自动映射，哪怕你只映射了一个字段，其他字段也不会再走驼峰转换。
解决办法不是删掉 <resultMap>，而是用「自动映射 + 手动补充」模式：
- 给
<resultMap>加上autoMapping="true"属性：<resultMap id="UserResultMap" type="User" autoMapping="true"> <id property="id" column="id"/> <!-- 其他字段如 user_name、create_time 会自动映射到 userName、createTime --> </resultMap>
- 确保
<resultMap>里的property名是驼峰，column是下划线，不要反着写 - 避免混用：不要在同一个
<resultMap>里既写autoMapping="true"又把所有字段都手动<result>出来，那样等于白开
实体类字段加了 @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 的映射流程里”。最常被忽略的是：显式 <resultMap>、注解绑定、以及 Spring Boot 下配置加载路径错位——这三处卡住，再对的参数也白搭。
