mybatis的实体类与数据库字段不一致

在 MyBatis 里，实体类属性名 与 数据库列名 不一致时，查询结果会出现 封装失败：
不会报错，但对应字段全部为 null（或基本类型的默认值）。
例如：
表格
复制
数据库列名	实体类属性名
user_name	userName
create_time	gmtCreate
如果直接写：
xml
复制
<select id="listUsers" resultType="com.xxx.User">
    SELECT user_name, create_time FROM t_user
</select>
返回的 List<User> 里，userName 与 gmtCreate 都是 null，因为 MyBatis 默认 “按列名找 setter” 失败。
四种解决方案
表格
复制
方案	用法	场景
1. 列别名	SQL 里起与属性一致的别名	快速、零配置
2. <resultMap>	手动映射列 ↔ 属性	最通用、最灵活
3. 开启驼峰自动映射	mapUnderscoreToCamelCase=true	下划线 ↔ 驼峰
4. 插件/工具	MyBatis-Plus、MapStruct 等	零 SQL、代码生成
1. 列别名（最简）
xml
复制
<select id="listUsers" resultType="com.xxx.User">
    SELECT
        user_name  AS userName,
        create_time AS gmtCreate
    FROM t_user
</select>
适合一次性 SQL，不改实体。
2. <resultMap>（最稳）
xml
复制
<resultMap id="BaseResultMap" type="com.xxx.User">
    <result column="user_name"  property="userName"/>
    <result column="create_time" property="gmtCreate"/>
</resultMap>

<select id="listUsers" resultMap="BaseResultMap">
    SELECT user_name, create_time FROM t_user
</select>
一次配置，多处复用；支持嵌套、关联、枚举、类型处理器等高级映射。
3. 开启驼峰自动映射（Spring Boot 常用）
yaml
复制
# application.yml
mybatis:
  configuration:
    map-underscore-to-camel-case: true
只要数据库是下划线，实体是驼峰，就无需任何额外配置。
限制：只能解决 user_name ↔ userName 这种纯下划线场景，列名与属性名完全对不上时无效。
4. 代码生成 / 插件
MyBatis-Generator、MyBatis-Plus、Fluent-MyBatis 等可自动生成 resultMap 或采用链式 API，无需手写 SQL。
快速选型建议
临时 SQL → 起别名
长期维护 → 写 <resultMap>
全项目统一 → 开启 mapUnderscoreToCamelCase + 必要时补充 resultMap
不想写 SQL → MyBatis-Plus 等插件
只要记住：不映射就 null，不会抛异常，但数据会“丢”。