从踩坑到精通：MyBatis驼峰映射开启后，为什么我的create_time还是null？

在Java持久层框架中，MyBatis的驼峰命名映射功能看似简单，却隐藏着不少让开发者"踩坑"的细节。当你已经按照文档配置了map-underscore-to-camel-case: true，却发现数据库中的create_time字段依然无法映射到实体类的createTime属性时，这种挫败感尤为强烈。本文将带你深入排查七个常见但容易被忽视的配置陷阱。

1. 配置位置：你的驼峰开关真的打开了吗？

很多开发者习惯在application.yml中这样配置：

yaml复制mybatis:
  mapper-locations: classpath:mapper/*.xml
  configuration-properties:
    map-underscore-to-camel-case: true  # 这里不生效！

关键区别在于configuration和configuration-properties这两个配置项。只有放在configuration下的配置才会被MyBatis核心处理：

yaml复制mybatis:
  configuration:
    map-underscore-to-camel-case: true  # 正确位置

注意：Spring Boot 2.x版本后，推荐使用mybatis.configuration.*而非旧版的mybatis.configuration-properties.*

2. 优先级冲突：当驼峰映射遇上resultMap

即使全局开启了驼峰映射，如果在XML中定义了resultMap，MyBatis会优先使用显式映射。检查你的Mapper文件：

xml复制<resultMap id="userResult" type="User">
    <result column="create_time" property="create_time"/> <!-- 这里破坏了驼峰规则 -->
</resultMap>

解决方案有两种：

1. 修改resultMap中的property为驼峰形式
2. 删除冗余映射，让全局配置生效

3. 注解SQL的特殊处理

在@Select等注解方式编写的SQL中，驼峰映射的行为有所不同。例如：

java复制@Select("SELECT create_time FROM users WHERE id = #{id}")
User findById(Long id);  // 可能映射失败

这时需要配合@Results注解显式声明：

java复制@Results({
    @Result(column = "create_time", property = "createTime")
})
@Select("SELECT create_time FROM users WHERE id = #{id}")
User findById(Long id);

4. 字段名中的多个下划线

当数据库字段包含多个下划线时，MyBatis的默认转换规则可能不符合预期。例如：

对于布尔类型字段，建议显式指定映射关系。

5. 类型处理器干扰

某些类型处理器可能会影响字段映射。检查是否注册了自定义处理器：

java复制@Configuration
public class MyBatisConfig {
    @Bean
    public ConfigurationCustomizer mybatisConfigurationCustomizer() {
        return configuration -> {
            // 检查是否覆盖了默认行为
            configuration.getTypeHandlerRegistry().register(...);
        };
    }
}

6. 实体类继承带来的映射问题

当使用继承时，父类的属性可能无法正确映射：

java复制public class BaseEntity {
    private Date createTime;  // 父类字段
}

public class User extends BaseEntity {
    // 子类字段
}

确保你的SQL查询包含了所有需要的字段：

sql复制-- 错误：缺少父类字段
SELECT id, name FROM user  

-- 正确：
SELECT id, name, create_time FROM user

7. 调试技巧：如何确认映射是否生效

在application.yml中增加日志配置：

yaml复制logging:
  level:
    org.mybatis: DEBUG

查看日志输出中的Setting autocommit语句附近是否有：

code复制DEBUG o.m.session.Configuration - Registered type handler alias: 'map-underscore-to-camel-case' -> 'true'

或者在代码中直接检查配置：

java复制@Autowired
private SqlSessionFactory sqlSessionFactory;

public void checkConfig() {
    boolean enabled = sqlSessionFactory.getConfiguration()
        .isMapUnderscoreToCamelCase();
    System.out.println("驼峰映射是否启用: " + enabled);
}

最后，当所有检查都通过但问题依旧时，尝试清理构建工具缓存并重新编译项目。Maven用户可以执行：

bash复制mvn clean compile

在实际项目中，我曾遇到过一个棘手的案例：Lombok的@Data注解与MyBatis的映射在某些IDE环境下会产生冲突。解决方法要么是添加完整的getter/setter，要么重建IDE的索引。这类问题提醒我们，框架之间的隐式交互往往比显式配置更值得关注。