仅VSCode运行Spring Boot应用时出现UserMapper Bean未找到错误

核心原因：MapStruct注解处理器未执行 #

你的UserMapper使用了MapStruct的@Mapper(componentModel = "spring")注解，这个注解需要MapStruct注解处理器在编译阶段生成对应的实现类（比如自动生成UserMapperImpl），只有这个生成的实现类才是Spring容器能识别并管理的Bean。

• 用./gradlew bootRun启动时，Gradle会自动执行完整的构建流程：先触发注解处理器生成实现类，再编译所有代码到classpath，最后启动应用，所以Spring能找到对应的Bean。
• 但VSCode直接通过「运行->不调试」启动时，它直接调用Java命令运行已有的class文件，没有触发Gradle的构建步骤，也就不会生成MapStruct的实现类，导致Spring找不到UserMapper类型的Bean。

VSCode启动的差异验证 #

你可以查看项目的build/classes/java/main/com/raven/api/mapper目录：

• 执行./gradlew bootRun后，目录里会出现UserMapperImpl.class文件；
• 直接用VSCode启动前如果没执行过构建，这个文件是不存在的，这就是Spring报错的直接原因。

解决办法 #

方法一：手动预构建 #

每次在VSCode启动应用前，先执行：

./gradlew compileJava

确保MapStruct的实现类被生成并编译。

方法二：配置VSCode自动预构建 #

修改launch.json，添加preLaunchTask让VSCode启动前自动执行Gradle编译任务：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "java",
      "name": "Launch ApiApplication",
      "request": "launch",
      "mainClass": "com.raven.api.ApiApplication",
      "projectName": "api",
      "env": {
        "MAIL_USERNAME": "x",
        "MAIL_PASSWORD": "x"
      },
      "preLaunchTask": "gradle: compileJava"
    }
  ]
}

如果VSCode提示找不到任务，你可以创建.vscode/tasks.json文件，配置Gradle编译任务：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "gradle: compileJava",
      "type": "gradle",
      "command": "compileJava",
      "args": [],
      "group": "build",
      "problemMatcher": [],
      "detail": "Compile Java sources including annotation processor outputs"
    }
  ]
}

内容的提问来源于stack exchange，提问作者moze