mapUnderscoreToCamelCase只对自动映射生效，即未定义resultMap、未用@Column/@TableField显式绑定、未在@Select中指定resultMap时才起作用；Spring Boot需在application.yml中配置mybatis.configuration.map-underscore-to-camel-case:true，且resultMap须设autoMapping="true"才能兼顾手动与自动映射。
为什么
设了没用？
多数人配了
却发现数据库字段
还是映射不到 Java 的
，根本原因不是配置写错，而是它只对「自动映射」生效——也就是没有显式写
、纯靠 MyBatis 自己猜列名和属性名时才起作用。
常见错误现象：
返回的
为
，但
能取到值（说明 getter 被调用了，但字段没设上）。
只在
里配了，但 Spring Boot 项目实际走的是
，得改
或
用了
注解 + 自定义 SQL，但没加
或写了
，此时自动映射被跳过
实体类字段用了
或
，显式覆盖了自动映射逻辑
Spring Boot 下正确开启全局驼峰转换
Spring Boot 2.0+ 默认不读
，必须通过 Spring 配置项启用。核心是让
实例的
属性为
，而 Spring Boot 的自动配置会把它从配置文件里拎出来设置。
在
中写：
如果用
：
确认没在代码里手动 new
并覆盖
属性，否则外部配置会被忽略
该配置影响所有未显式指定
的
语句，包括
、XML 中的
和通用 Mapper 的方法
XML 中写了
还想用驼峰？别写全量映射
一旦 XML 里出现
，MyBatis 就默认关闭自动映射，哪怕你只映射了一个字段，其他字段也不会再走驼峰转换。
解决办法不是删掉
，而是用「自动映射 + 手动补充」模式：
给
加上
属性：
确保
里的
名是驼峰，
是下划线，不要反着写
避免混用：不要在同一个
里既写
又把所有字段都手动
出来，那样等于白开
实体类字段加了
或
会影响吗？
会，而且优先级更高。MyBatis-Plus 的
或 JPA 的
会直接绑定列名到字段，绕过
的转换逻辑。
如果你用了 MyBatis-Plus，且希望保留驼峰配置，就别给字段加
；加了就得显式写对
，否则映射失败
的
或
等属性不会干扰映射，但
显式指定了列名，就不再走自动转换
纯 MyBatis（没集成 MP）不识别这些注解，所以它们只在对应框架下生效，别误以为是 MyBatis 原生行为
配置生效的关键不在“写没写”，而在“有没有被真正应用到当前 SQL 的映射流程里”。最常被忽略的是：显式
、注解绑定、以及 Spring Boot 下配置加载路径错位——这三处卡住，再对的参数也白搭。
mapUnderscoreToCamelCasemapUnderscoreToCamelCase=trueuser_nameuserNameUser user = mapper.selectById(1);user.userNamenulluser.getUserName()mybatis-config.xmlMybatisAutoConfigurationapplication.ymlapplication.properties@SelectresultTyperesultMap@Column(name = "user_name")@Resultsmybatis-config.xmlConfigurationmapUnderscoreToCamelCasetrueapplication.ymlmybatis:
configuration:
map-underscore-to-camel-case: trueapplication.propertiesmybatis.configuration.map-underscore-to-camel-case=trueSqlSessionFactoryBeanconfigurationresultMapselect@SelectautoMapping="true"
propertycolumnautoMapping="true"@TableField@Column@TableField(value = "user_name")@Column(name = "user_name")mapUnderscoreToCamelCase@TableFieldvalue@TableFieldexist = falsefillvalue