1. #{ }和${ }混淆使用

问题：#{}是预编译处理，${}是字符串替换。使用${}可能导致SQL注入。

错误示例：

@Select("select * from user where name = ${name}")
List<User> findByName(@Param("name") String name);

解决方案：优先使用#{}，特殊场景(如表名动态化)才用${}并做好过滤。

@Select("select * from user where name = #{name}")
List<User> findByName(@Param("name") String name);

2. 实体类属性与数据库字段不对应

问题：当Java属性名与数据库字段名不一致时，查询结果为null。

错误示例：

public class User {
    private String userName;  // 数据库字段是user_name
}

解决方案：使用@Result注解或resultMap映射。

<resultMap id="userMap" type="User">
    <result property="userName" column="user_name"/>
</resultMap>

3. 动态SQL中的条件判断陷阱

问题：<if test="">中使用OGNL表达式，常见判断错误。

错误示例：

<if test="name != null and name != ''">

解决方案：正确使用OGNL判断空字符串。

<if test="name != null and name.toString() != ''">

4. 分页查询性能问题

问题：直接使用limit在大数据量时性能差。

错误示例：

@Select("select * from user limit #{offset}, #{size}")
List<User> findPage(@Param("offset") int offset, @Param("size") int size);

解决方案：使用分页插件或优化SQL。

@Select("select * from user where id > #{lastId} order by id limit #{size}")
List<User> findPage(@Param("lastId") long lastId, @Param("size") int size);

5. 一级缓存引起的数据不一致

问题：MyBatis一级缓存(SqlSession级别)可能导致读取到脏数据。

解决方案：在需要实时数据的查询上添加flushCache选项。

<select id="getUser" resultType="User" flushCache="true">
    select * from user where id=#{id}
</select>

6. 集合嵌套查询N+1问题

问题：一对多查询时可能产生N+1查询问题。

错误示例：

<resultMap id="blogMap" type="Blog">
    <collection property="comments" column="id" select="findCommentsByBlogId"/>
</resultMap>

解决方案：使用JOIN查询一次性获取数据。

<resultMap id="blogMap" type="Blog">
    <collection property="comments" ofType="Comment">
        <id property="id" column="comment_id"/>
    </collection>
</resultMap>

7. 批量插入性能低下

问题：循环单条插入效率低。

错误示例：

for (User user : userList) {
    userMapper.insert(user);
}

解决方案：使用批量插入语法。

<insert id="batchInsert">
    insert into user (name, age) values
    <foreach collection="list" item="item" separator=",">
        (#{item.name}, #{item.age})
    </foreach>
</insert>

8. 枚举类型处理不当

问题：默认情况下枚举按名称存储，可能不符合需求。

解决方案：实现自定义TypeHandler或使用@EnumValue(MyBatis-Plus)。

public enum Gender {
    @EnumValue
    MALE(1), FEMALE(2);
    private int code;
    // ...
}

9. 延迟加载失效

问题：延迟加载需要配置且容易因Session关闭而失败。

解决方案：正确配置并确保Session生命周期。

<settings>
    <setting name="lazyLoadingEnabled" value="true"/>
    <setting name="aggressiveLazyLoading" value="false"/>
</settings>

10. 主键生成策略混淆

问题：不同数据库主键生成策略不同，容易混淆使用。

错误示例：MySQL中使用useGeneratedKeys但未设置自增。

解决方案：根据数据库正确配置。

<insert id="insert" useGeneratedKeys="true" keyProperty="id">
    insert into user(name) values(#{name})
</insert>

总结

MyBatis虽灵活强大，但细节坑点不少。掌握这些高频问题的解决方案，能显著提升开发效率和系统稳定性。建议在项目中建立MyBatis使用规范，避免重复踩坑。