Spring Boot 集成 MyBatis 操作数据库详解

开启日志

调试阶段建议开启 SQL 日志，直观查看执行语句。在 application.yml 中配置如下：

mybatis:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

开发实战：注解与 XML

MyBatis 支持两种主要开发模式，可根据业务复杂度灵活选择。

注解模式（简单场景）

对于单表 CRUD 操作，注解方式更简洁。使用 @Mapper 标记接口，配合 @Select、@Insert 等注解直接定义 SQL。

@Mapper
public interface UserInfoMapper {
    // 根据 ID 查询用户
    @Select("select * from user_info where id = #{id}")
    UserInfo queryById(Integer id);

    // 插入并返回自增主键
    @Insert("insert into user_info (username, password) values (#{username}, #{password})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    Integer insert(UserInfo userInfo);
}

XML 模式（复杂场景）

当涉及多表关联、动态 SQL 或复杂映射时，XML 文件是更好的选择。它能让 SQL 逻辑清晰可见，方便后续调优。

<mapper namespace="com.example.demo.mapper.UserInfoXmlMapper">
    <resultMap id="BaseMap" type="com.example.demo.model.UserInfo">
        <id column="id" property="id"></id>
        <result column="delete_flag" property="deleteFlag"></result>
    </resultMap>
    
    <select id="queryAllUser" resultMap="BaseMap">
        select * from user_info
    </select>
</mapper>

核心原理：#{} 与 ${} 的区别

这是面试高频点，也是安全关键。两者虽都用于参数传递，但底层机制完全不同。

经验之谈：除非万不得已（如动态表名），否则一律优先使用 #{}。

多表关联查询

MyBatis 处理联表查询的核心在于结果集映射。通过 LEFT JOIN 获取数据后，利用 resultMap 将不同表的字段映射到实体类属性上。

@Select("SELECT ta.id, ta.title, tb.username FROM articleinfo ta LEFT JOIN user_info tb ON ta.uid = tb.id WHERE ta.id = #{id}")
ArticleInfo queryUserByUid(Integer id);

企业级规范与建议

命名规范

1. 数据库层：统一采用蛇形命名法（snake_case），如 user_info。
2. Java 层：开启驼峰转换，避免手动映射。在配置文件中设置：

   mybatis:
     configuration:
       map-underscore-to-camel-case: true
   

连接池优化

推荐使用 Druid 连接池，它不仅提供高性能，还内置了强大的监控功能。

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-3-starter</artifactId>
    <version>1.2.21</version>
</dependency>

总结

MyBatis 通过灵活的映射机制和 SQL 控制力，有效平衡了开发效率与性能需求。在实际项目中，建议遵循以下原则：

• 简单查询用注解，复杂逻辑走 XML。
• 始终警惕 SQL 注入，默认使用预编译参数。
• 保持数据库与 Java 对象的命名风格一致。

掌握这些基础后，即可构建出稳健且易维护的持久层架构。