spring boot配置mybatis-plus
时间: 2025-03-18 16:36:55 浏览: 35
### MyBatis-Plus 在 Spring Boot 中的配置教程
#### 1. 添加依赖
为了在 Spring Boot 项目中集成 MyBatis-Plus,需要在 `pom.xml` 文件中添加相应的 Maven 依赖。以下是针对不同版本的依赖配置:
对于 **Spring Boot 2.x** 或更低版本:
```xml
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.3</version> <!-- 版本号根据实际需求调整 -->
</dependency>
```
如果使用的是 **Spring Boot 3.x** 及以上版本,则需引入支持 Spring Boot 3 的动态数据源管理器:
```xml
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot3-starter</artifactId>
<version>4.3.1</version> <!-- 版本号根据实际需求调整 -->
</dependency>
```
上述配置适用于读写分离场景[^4]。
---
#### 2. 数据库连接配置
在项目的 `src/main/resources/application.yml` 文件中定义数据库连接参数以及 MyBatis-Plus 的相关设置。以下是一个完整的示例配置:
```yaml
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
username: root
password: your_password
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启 SQL 日志打印
mapper-locations: classpath:/mapper/*.xml # 映射 XML 文件路径
type-aliases-package: com.example.demo.entity # 实体类所在包名
```
此部分配置明确了数据库驱动、URL 地址、用户名密码等内容,并设置了 MyBatis-Plus 的日志记录方式和 Mapper 文件位置[^3]。
---
#### 3. 创建实体类与 Mapper 接口
假设存在一张名为 `user` 的表,对应的 Java 实体类可以这样编写:
```java
package com.example.demo.entity;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
@Data
@TableName("user") // 表名称映射
public class User {
@TableField(value = "id", exist = true)
private Long id;
@TableField(value = "name")
private String name;
@TableField(value = "age")
private Integer age;
}
```
接着创建对应的 Mapper 接口继承自 `BaseMapper<T>` 类型接口:
```java
package com.example.demo.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.demo.entity.User;
import org.apache.ibatis.annotations.Mapper;
@Mapper
public interface UserMapper extends BaseMapper<User> {
// 自定义方法可在此处声明
}
```
通过这种方式,可以直接利用 MyBatis-Plus 提供的基础 CRUD 方法而无需额外实现逻辑。
---
#### 4. 启动测试
最后,在主程序入口类上标注 `@EnableTransactionManagement` 注解以启用事务功能(视业务需求决定是否必要)。随后运行应用程序并验证其正常工作状态。
```java
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.transaction.annotation.EnableTransactionManagement;
@SpringBootApplication
@EnableTransactionManagement
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
```
---
#### 注意事项
当同时引入 `mybatis-spring-boot-starter` 和 `mybatis-plus-boot-starter` 时可能会引发冲突问题[^2]。因此建议只保留其中一个作为主要 ORM 工具来减少潜在兼容性风险。
---
阅读全文
相关推荐




