问题现象

在 IntelliJ IDEA 中启动 Spring Boot 项目 rs-platform 时，报如下错误：

org.springframework.beans.factory.CannotLoadBeanClassException: 
Error loading class [com.rstoolbox.global.domain.system.vo.SysTenantVoToTenantListVoMapperImpl] 
for bean with name 'sysTenantVoToTenantListVoMapperImpl' 
defined in file [...\rs-platform\target\classes\...\SysTenantVoToTenantListVoMapperImpl.class]: 
problem with class file or dependent class

应用直接启动失败，Spring 容器初始化阶段就被打断。

排查过程

1. 定位出错的文件

从异常堆栈可以看出，出问题的类是 SysTenantVoToTenantListVoMapperImpl，位于 rs-platform/target/classes/ 目录下。这是一个 MapStruct 在编译期自动生成的 Mapper 实现类（@Generated 注解标注）。

2. 分析根因

错误信息 problem with class file or dependent class 通常意味着 .class 文件的字节码存在以下问题之一：

• 编译时依赖的类版本与运行时不一致
• 字节码被损坏或不完整
• 不同编译器产生的字节码存在兼容性问题

结合日常开发习惯——同时在 VSCode（写代码 + AI 辅助）和 IDEA（编译运行）中打开同一个项目，很快锁定了根因：

VSCode 的 Java 扩展默认开启了自动编译（autobuild），使用 Eclipse JDT 编译器，编译产物输出到 target 目录；而 IDEA 使用 javac 编译器，也输出到同一个 target 目录。两个编译器交替写入同一个目录，导致 .class 文件混乱。

3. 验证

查看 target/generated-sources/annotations/ 下的 MapStruct 生成源码：

@Generated(
    value = "org.mapstruct.ap.MappingProcessor",
    date = "2026-07-31T16:24:24+0800",
    comments = "version: 1.6.3, compiler: javac, environment: Java 17 (Oracle Corporation)"
)
@Component
public class SysTenantVoToTenantListVoMapperImpl implements SysTenantVoToTenantListVoMapper {
    // ...
}

生成时间是 7 月 31 日，恰好是使用 VSCode 编辑代码的时间点，证实了 VSCode 的编译行为污染了 target 目录。

解决方案

第一步：清理脏数据

mvn clean

删除所有模块的 target 目录，清空所有旧的编译产物。

第二步：配置 VSCode 关闭自动编译

在项目根目录的 .vscode/settings.json 中配置：

{
    "java.compile.nullAnalysis.mode": "disabled",
    "java.configuration.updateBuildConfiguration": "disabled",
    "java.autobuild.enabled": false
}

三项配置的含义：

配置	值	作用
java.autobuild.enabled	false	关闭自动编译，不往 target 写 .class
java.compile.nullAnalysis.mode	disabled	关闭空指针检查，减少干扰
java.configuration.updateBuildConfiguration	disabled	pom.xml 变更时不弹窗询问

第三步：重启并重建

重启 VSCode 使配置生效，回到 IDEA 重新运行 RsPlatformApplication，IDEA 用自己的编译器重新编译，启动正常。

原理总结

┌─────────────┐         ┌─────────────┐
│   VSCode    │         │    IDEA     │
│             │         │             │
│ Eclipse JDT │         │   javac     │
│  编译器     │         │   编译器    │
│             │         │             │
└──────┬──────┘         └──────┬──────┘
       │                       │
       │    冲突！              │
       ▼                       ▼
  ┌─────────────────────────────────┐
  │          target/                │
  │  (两个编译器写入同一个目录)      │
  └─────────────────────────────────┘

配置 autobuild: false 后：

┌─────────────┐         ┌─────────────┐
│   VSCode    │         │    IDEA     │
│  纯编辑器   │         │   javac     │
│  不编译     │         │   编译器    │
│             │         │             │
└─────────────┘         └──────┬──────┘
                               │
                               ▼
                      ┌─────────────────┐
                      │     target/     │
                      │  (IDEA 独占)    │
                      └─────────────────┘

延伸思考

这个问题本质上是一个多工具协作的边界问题。当使用多个 IDE/编辑器操作同一个项目时，需要明确各自的职责边界：

• VSCode：负责代码编辑、AI 辅助、Git 操作
• IDEA：负责编译、运行、调试、Maven 管理

通过关闭 VSCode 的自动编译，让两个工具各司其职、互不干扰，既保留了 VSCode 轻量编辑和 AI 辅助的优势，又不影响 IDEA 强大的 Java 项目管理能力。