【已解决】SpringBoot3项目整合Mybatis-plus启动项目报错：Invalid bean definition with name ‘xxxMapper‘ defined in flle

在使用Spring Boot 3项目整合MyBatis-Plus时，开发者有时会遇到启动时出现“Invalid bean definition with name 'xxxMapper' defined in file ...”的错误。这种问题通常与Bean的定义、扫描路径或MyBatis-Plus的配置有关。下面，我将详细解读这个问题，并提供相应的解决方案。

问题分析

当Spring Boot启动时，它会扫描所有的组件并初始化Bean。若存在重复定义或配置错误的Bean，便会导致这样的错误提示。对于MyBatis-Plus而言，Mapper接口需要通过特定的注解来标记，并正确配置对应的包扫描路径。

解决方案

1. 检查Mapper接口的注解： 确保你的Mapper接口上有正确的@Mapper注解，或者在配置类中使用@MapperScan注解。例如：

```java import org.apache.ibatis.annotations.Mapper;

@Mapper public interface UserMapper { // 定义操作数据库的方法 User selectById(Long id); } ```

或者使用@MapperScan：

```java import org.mybatis.spring.annotation.MapperScan; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication @MapperScan("com.example.mapper") // 扫描指定包下的Mapper public class MyApp { public static void main(String[] args) { SpringApplication.run(MyApp.class, args); } } ```

1. 检查配置文件： 确保你的application.yml或application.properties中正确配置了MyBatis-Plus的相关信息，例如数据库连接信息和MyBatis的配置：

yaml spring: datasource: url: jdbc:mysql://localhost:3306/yourdb username: yourusername password: yourpassword mybatis-plus: mapper-locations: classpath*:/mapper/**/*.xml # Mapper XML文件位置 type-aliases-package: com.example.entity # 实体类所在包

1. 确认依赖正确： 确保在pom.xml中已经引入了相关的MyBatis-Plus依赖，例如：

xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.4.3.4</version> <!-- 注意版本号可以根据需求选择 --> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.26</version> <!-- 确保使用的MySQL驱动版本 --> </dependency>

1. 清理和重建项目： 有时IDE可能会缓存一些旧的配置，建议清理项目并重建。在IntelliJ IDEA中可以使用“Build”菜单下的“Rebuild Project”功能。

2. 查看具体的错误信息： 启动时的错误信息往往包含了具体的错误原因，尤其是对于像“Invalid bean definition”这种错误。查看详细堆栈信息，确定具体是哪一个Mapper定义出了问题。

Demo代码示例

以下是一个简单的Spring Boot 3整合MyBatis-Plus的示例项目结构：

src
└── main
    ├── java
    │   └── com
    │       └── example
    │           ├── MyApp.java
    │           ├── entity
    │           │   └── User.java
    │           └── mapper
    │               └── UserMapper.java
    └── resources
        ├── application.yml
        └── mapper
            └── UserMapper.xml

User.java示例：

package com.example.entity;

import lombok.Data;

@Data
public class User {
    private Long id;
    private String name;
    private Integer age;
}

通过以上分析和解决方案，你应该能够解决“Invalid bean definition”相关的错误，顺利启动Spring Boot与MyBatis-Plus的集成项目。