MyBatis-Plus 启动时报错：java.lang.annotation.AnnotationFormatError，已添加 MapperScan 注解

问题描述

你在使用 MyBatis-Plus 时遇到了启动报错，错误信息为 java.lang.annotation.AnnotationFormatError，即使已经添加了 @MapperScan 注解。

可能原因及解决方法

1. 检查 MapperScan 注解的配置

确保 @MapperScan 注解的配置正确，特别是包路径是否正确。通常，@MapperScan 应该放在你的主应用程序类或配置类上，并且指定扫描的包路径。

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

@SpringBootApplication
@MapperScan("com.example.yourpackage.mapper")
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 检查 Mapper 接口

确保所有的 Mapper 接口都在你指定的包路径下，并且这些接口上没有缺少必要的注解。例如，接口上应该有 @Mapper 注解。

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.yourpackage.entity.YourEntity;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface YourMapper extends BaseMapper<YourEntity> {
    // Your methods here
}

3. 检查依赖和版本

确保你的 MyBatis-Plus 和 MyBatis 的版本兼容，并且所有的依赖都已经正确导入。检查你的 pom.xml 或 build.gradle 文件。

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.4.3.4</version>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

4. 检查其他注解的正确性

有时，其他注解的配置不正确也可能导致这个错误。确保你的所有注解都正确配置，并且没有冲突。

5. 清理和重建项目

尝试清理并重建你的项目，以确保没有缓存的旧版本代码或编译问题。

# For Maven
mvn clean install

# For Gradle
gradle clean build

进一步调试

如果上述步骤未能解决问题，可以启用更详细的日志输出，查看更具体的错误信息，以便进一步分析和解决。

# application.properties
logging.level.root=DEBUG
logging.level.com.example.yourpackage=DEBUG

通过上述步骤和检查，应该能够找到并解决 java.lang.annotation.AnnotationFormatError 问题。