Spring Boot 集成 MyBatis 操作数据库指南

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

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

注意 @Options 里的 useGeneratedKeys，这是告诉 MyBatis 去拿数据库生成的主键值回传给对象。

XML 映射模式

当涉及多表查询或动态 SQL 时，XML 模式是更好的选择，逻辑解耦更清晰。

<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>

这里定义了 resultMap 来处理字段名和属性名的映射，比如数据库的 delete_flag 对应 Java 的 deleteFlag。

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

这是面试常考点，也是安全红线。两者虽然都能传参，但底层机制完全不同。

实际开发中，除非万不得已（比如动态表名），否则一律优先使用 #{}。

多表关联查询进阶

MyBatis 处理单表或多表的核心逻辑是一致的，关键在于通过映射关系把联表 SQL 的运行结果关联到实体类。

@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. 蛇形命名：表名和字段名统一用小写字母，单词间用下划线分割，例如 user_info。
2. 开启驼峰转换：在 yml 配置中开启 map-underscore-to-camel-case: true，这样数据库的 abc_xyz 就能自动映射到 Java 的 abcXyz，省去大量手动配置。

Druid 连接池配置

为了获得更强大的监控功能，推荐引入阿里巴巴开源的 Druid 连接池：

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

总结

MyBatis 通过灵活的配置和 SQL 映射，显著提升了 Java 开发效率。在实际项目中，应根据业务复杂度灵活选择注解或 XML 模式，并始终优先使用 #{} 规避安全风险。配合规范的命名和连接池管理，就能构建出稳健的持久层架构。

参考资料

• MyBatis 官方文档
• Alibaba Druid 配置指南