springboot怎么配置mybatisplus
时间: 2025-05-10 11:25:24 浏览: 17
### 如何在 Spring Boot 中配置 MyBatis-Plus
#### 1. 添加 Maven 或 Gradle 依赖
为了在 Spring Boot 项目中集成 MyBatis-Plus,首先需要引入必要的依赖项。以下是基于 Maven 的 `pom.xml` 文件中的依赖配置:
```xml
<dependencies>
<!-- Spring Boot Starter -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- MyBatis Plus -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.1</version>
</dependency>
<!-- 数据库驱动 (MySQL为例) -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<!-- Lombok 可选工具 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
```
对于 Gradle 用户,则可以在 `build.gradle` 文件中添加如下内容:
```gradle
implementation 'org.springframework.boot:spring-boot-starter-web'
implementation 'com.baomidou:mybatis-plus-boot-starter:3.5.1'
runtimeOnly 'mysql:mysql-connector-java'
annotationProcessor 'org.projectlombok:lombok'
```
以上步骤完成了基础环境的搭建[^1]。
---
#### 2. 配置数据源和 MyBatis-Plus 属性
在项目的 `application.yml` 或 `application.properties` 文件中完成数据库连接以及 MyBatis-Plus 的基本属性设置。以下是一个典型的 YAML 配置文件示例:
```yaml
spring:
datasource:
url: jdbc:mysql://localhost:3306/your_database_name?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
username: root
password: your_password
driver-class-name: com.mysql.cj.jdbc.Driver
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启 SQL 日志打印
global-config:
db-config:
id-type: auto # 主键策略
```
上述配置指定了数据库 URL、用户名、密码以及其他 MyBatis-Plus 的全局参数。
---
#### 3. 创建实体类并启用注解支持
创建与表结构对应的 Java 实体类,并通过 MyBatis-Plus 提供的注解简化开发过程。例如:
```java
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
@TableName("user") // 映射到 user 表
public class User {
private Long id; // 自动映射为主键字段
@TableField("name")
private String name;
public Long getId() { return id; }
public void setId(Long id) { this.id = id; }
public String getName() { return name; }
public void setName(String name) { this.name = name; }
}
```
此部分利用了 MyBatis-Plus 注解来减少 XML 配置的工作量[^2]。
---
#### 4. 定义 Mapper 接口
定义一个继承自 `BaseMapper<T>` 的接口作为 DAO 层的核心组件。MyBatis-Plus 将会自动扫描这些接口并将其实现注入到 Spring Bean 容器中。
```java
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
public interface UserMapper extends BaseMapper<User> {}
```
当使用默认包路径时(如 `com.example.demo.mapper`),可以通过 `MapperScannerConfigurer.postProcessBeanDefinitionRegistry()` 方法实现自动化注册[^3]。
如果未按照约定命名空间放置 Mapper 类,则需手动指定扫描范围,在 `application.yml` 中加入以下内容:
```yaml
mybatis-plus:
mapper-locations: classpath:mapper/*.xml
typeAliasesPackage: com.example.demo.entity
```
---
#### 5. 测试功能
编写单元测试验证 CRUD 功能是否正常工作。例如:
```java
@SpringBootTest
class UserServiceTest {
@Autowired
private UserMapper userMapper;
@Test
void testInsertUser() {
User user = new User();
user.setName("John Doe");
int result = userMapper.insert(user);
Assertions.assertTrue(result > 0); // 插入成功返回受影响行数大于零
}
}
```
至此,整个流程结束,实现了 MyBatis-Plus 在 Spring Boot 环境下的快速上手。
---
阅读全文
相关推荐


















