mapperscan扫描爆红

### MyBatis Plus 中 `MapperScan` 报错解决方案

在使用 MyBatis Plus 开发过程中，如果遇到 `MapperScan` 导致的报错问题，通常是因为 Spring Boot 应用未能正确扫描到 Mapper 接口。以下是详细的解决方案：

#### 1. 确认依赖版本兼容性
确保使用的 MyBatis Plus 版本与其他框架组件保持良好兼容性。例如，可以尝试更换为特定版本的 MyBatis Plus 启动器[^3]。

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.0.5</version>
</dependency>

#### 2. 正确配置 `application.properties`
确认配置文件中的路径设置无误，以便能够找到所有的 XML 映射文件。对于 MyBatis Plus 来说，应当合理设定 mapper 文件的位置属性[^1]。

mybatis-plus.mapper-locations=classpath*:mapper/*.xml

#### 3. 使用 `@MapperScan` 注解
为了使应用程序能自动发现并注册所有定义好的 Mapper 接口，需在主类上添加 `@MapperScan` 注解，并指明这些接口所在的包名位置[^4]。

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
@MapperScan("com.example.project.mapper") // 替换为实际的包路径
public class Application {
    
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

#### 4. 处理 IDE 提示错误
有时即使程序本身工作正常，但在某些情况下（如 IDEA），仍可能出现不必要的编译期警告或红线标记。这是因为 IDE 对于动态代理生成的对象缺乏足够的理解能力所致。此时可以通过调整项目的 Lombok 插件支持或是忽略此类非致命性的提示来改善用户体验[^2]。

通过上述措施，应该能够有效解决由 `MapperScan` 引起的各种异常情况，从而让基于 MyBatis Plus 的项目更加稳定可靠地运行起来。