微服务项目 - SpringBoot 2.x 升级到 SpringBoot 3.2.5，保姆级避坑

### 配置 Spring Boot 3.2.5 和 MyBatis-Plus 为了在 Spring Boot 3.2.5 中成功集成 MyBatis-Plus，需要特别注意版本兼容性和配置细节。以下是具体的实现方法： #### 1. 添加 Maven 依赖 确保 `pom.xml` 文件中包含以下依赖项。由于 Spring Boot 版本较高，需确认使用的 MyBatis-Plus 版本与其兼容。 ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> <!-- 确保此版本与Spring Boot 3.x兼容 --> </dependency> <!-- 数据库驱动 (以MySQL为例) --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> ``` 上述代码片段展示了如何引入 MyBatis-Plus 及其所需的数据库连接器[^1]。 #### 2. 配置 application.yml 或 application.properties 在项目的资源配置文件中定义数据源和 MyBatis-Plus 的相关参数。 ##### 使用 YAML 格式： ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/your_database?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日志打印 mapper-locations: classpath*:mapper/*.xml # 映射XML路径 ``` 以上配置指定了 MySQL 数据源及其属性，并设置了 MyBatis-Plus 的映射 XML 路径和 SQL 日志输出方式[^2]。 #### 3. 创建实体类 创建一个简单的实体类用于测试。假设有一个名为 `User` 的表，则对应的 Java 实体如下所示： ```java import com.baomidou.mybatisplus.annotation.TableField; import com.baomidou.mybatisplus.annotation.TableName; @TableName("user") // 对应数据库中的表名 public class User { private Long id; @TableField("username") private String name; private Integer age; 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; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } } ``` 通过注解的方式绑定字段到数据库列[^3]。 #### 4. 定义 Mapper 接口 Mapper 接口继承自 `BaseMapper<T>` 类型接口，从而获得 CRUD 方法支持。 ```java import com.baomidou.mybatisplus.core.mapper.BaseMapper; public interface UserMapper extends BaseMapper<User> {} ``` 无需编写任何具体实现逻辑，因为这些操作已被内置提供。 #### 5. 处理潜在的兼容性问题 如果遇到类似于 `Invalid value type for attribute &#39;factoryBeanObjectType&#39;` 的错误，请检查是否存在冲突的 Starter 包或其他第三方插件干扰。必要时升级或调整 MyBatis-Spring 启动器至最新稳定版[^4]。 --- ###