添加依赖后Maven项目出现Could not find or load main class错误

• 检查Lombok配置

  • 确认pom.xml里Lombok的scope为provided，若设为compile可能打乱编译后的字节码结构。
  • 确保VS Code已安装Lombok插件，同时在settings.json中开启java.compiler.annotationProcessing.enabled为true，否则注解处理不生效会导致类结构异常。

• 排查Spring Boot Starter Test依赖冲突

  • 执行mvn dependency:tree查看依赖树，找出Test依赖引入的版本冲突或重复依赖，手动排除不兼容的部分。
  • 确认Test依赖的scope是test，若误设为compile，测试相关类会被打包进主程序，干扰主类加载。

• 处理Spring Cloud OpenFeign依赖兼容问题

  • 确保pom.xml中引入了Spring Cloud的dependencyManagement，保证OpenFeign与Spring Boot版本匹配（比如Spring Boot 2.x对应Spring Cloud Hoxton/Ilford系列，3.x对应2022.0.x系列）。
  • 检查OpenFeign相关注解配置是否正确，避免因Spring上下文加载异常间接引发主类找不到的问题。

• 清理缓存并重新编译

  • 执行mvn clean install -U，强制更新快照依赖并清理旧编译产物，避免缓存中的错误字节码影响运行。
  • 在VS Code中执行「Java: Clean Java Language Server Workspace」命令，彻底清理语言服务器缓存后重新加载项目。

• 验证主类配置

  • 确认主类上的@SpringBootApplication注解无误，不要误加@SpringBootTest这类测试注解。
  • 检查spring-boot-maven-plugin是否指定了正确的主类路径，示例配置：

    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
            <mainClass>com.yourpackage.YourMainClass</mainClass>
        </configuration>
    </plugin>
    

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