安装指南 - 依赖引入
郭胜凯2026/08/17
说明
在这里, 我们将以一个新的 Spring Boot Mybatis 项目为例, 介绍如何将 Smart Mybatis 集成到您现有的的项目中。
环境要求
- Java 17+
- Spring Boot 3.x
- MyBatis Spring Boot Starter 3.x
- Smart MyBatis 3.0.2
Smart MyBatis 是 MyBatis 的增强层，不替换 SqlSessionFactory、Mapper 扫描或 XML/注解 SQL。项目必须显式引入官方 MyBatis Starter。
Maven
在您的 pom.xml 文件中添加以下依赖
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>3.0.5</version>
</dependency>
<dependency>
<groupId>ink.icoding</groupId>
<artifactId>spring-boot-starter-smart-mybatis</artifactId>
<version>3.0.2</version>
</dependency>
数据库驱动由业务项目按实际数据库引入。例如使用 H2：
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>runtime</scope>
</dependency>
Gradle
在您的 build.gradle 文件中添加以下依赖
implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.5'
implementation 'ink.icoding:spring-boot-starter-smart-mybatis:3.0.2'
runtimeOnly 'com.h2database:h2'
安装完成后，Starter 默认启用。请继续阅读项目配置，至少配置数据源；生产环境通常应保持 auto-sync-db=false。