使用mybatis实例类和MySQL表的字段不一致怎么办

在 MyBatis 中，当 Java 实体类的属性名与数据库表的字段名不一致时，会导致查询结果无法正确映射。以下是几种常见解决方案及代码示例：

---

1. 使用 resultMap 显式映射（推荐）

场景：字段名与属性名差异较大，需自定义映射规则

实现步骤：

1. 在 XML 映射文件中定义 resultMap
2. 通过 column 指定数据库字段，property 指定 Java 属性

示例代码：

<!-- UserMapper.xml -->
<resultMap id="userResultMap" type="com.example.User">
    <id column="user_id" property="id"/>         <!-- 数据库字段 user_id → 属性 id -->
    <result column="user_name" property="name"/> <!-- 数据库字段 user_name → 属性 name -->
    <result column="create_time" property="createTime"/> <!-- 下划线转驼峰 -->
</resultMap>
<select id="selectUserById" resultMap="userResultMap">
    SELECT user_id, user_name, create_time FROM user WHERE user_id = #{id}
</select>

---

2. 启用驼峰命名自动映射

场景：数据库字段使用下划线命名（如 user_name），Java 属性使用驼峰命名（如 userName）

实现步骤：

1. 在 MyBatis 配置中开启驼峰转换规则

示例代码（application.properties）：

# Spring Boot 配置
mybatis.configuration.map-underscore-to-camel-case=true

效果：
无需额外配置，MyBatis 自动将 user_name 映射到 userName。

---

3. 在 SQL 查询中使用别名

场景：临时适配字段名与属性名的差异

实现步骤：

1. 在 SQL 中为字段设置别名，与 Java 属性名一致

示例代码：

<select id="selectUserById" resultType="com.example.User">
    SELECT 
        user_id AS id,        <!-- 别名 id 对应属性 id -->
        user_name AS name,    <!-- 别名 name 对应属性 name -->
        create_time AS createTime 
    FROM user 
    WHERE user_id = #{id}
</select>

---

4. 使用 @Results 注解映射（注解方式）

场景：使用注解而非 XML 配置

实现步骤：

1. 在 Mapper 接口方法上使用 @Results 和 @Result 注解

示例代码：

@Select("SELECT user_id, user_name, create_time FROM user WHERE user_id = #{id}")
@Results({
    @Result(property = "id", column = "user_id"),
    @Result(property = "name", column = "user_name"),
    @Result(property = "createTime", column = "create_time")
})
User selectUserById(int id);

---

5. 动态 SQL 中的字段映射

场景：在 <if> 等动态标签中引用字段

实现步骤：

1. 使用 column 属性指定数据库字段名

示例代码：

<select id="findUsers" resultType="com.example.User">
    SELECT 
        user_id AS id,
        user_name AS name,
        create_time AS createTime 
    FROM user
    <where>
        <if test="name != null">
            AND user_name = #{name}  <!-- 数据库字段名直接使用 -->
        </if>
    </where>
</select>

---

总结

方案	适用场景	优点	缺点
resultMap	复杂字段映射（如类型转换、嵌套对象）	灵活、精确控制	配置较繁琐
驼峰自动映射	字段与属性名仅命名风格不同（下划线 ↔ 驼峰）	零配置，简单快捷	无法处理特殊映射
SQL 别名	临时适配或简单字段映射	无需额外配置	可维护性较差
@Results 注解	使用注解配置的轻量级场景	代码内聚，无需 XML	复杂映射时代码冗长

推荐优先级：

1. 驼峰自动映射（简单场景）
2. resultMap（复杂映射）
3. SQL 别名（临时适配）