VSCode运行Spring Boot+Gradle项目无法自动解析类路径报错

报错信息 #

Cannot resolve the modulepaths/classpaths automatically, please specify the value in the launch.json.
来源：Debugger for Java 扩展

按顺序执行以下排查操作，每步完成后验证问题是否解决 #

• 修复.classpath配置缺失项
  打开项目根目录下的.classpath文件，找到Gradle类路径容器条目：

  <classpathentry kind="con" path="org.eclipse.buildship.core.gradleclasspathcontainer"/>
  

  替换为带完整属性的配置：

  <classpathentry kind="con" path="org.eclipse.buildship.core.gradleclasspathcontainer">
      <attributes>
          <attribute name="gradle_scope" value="main,test"/>
          <attribute name="gradle_used_by_scope" value="main,test"/>
      </attributes>
  </classpathentry>
  

  修改完成后按快捷键Ctrl+Shift+P（macOS为Cmd+Shift+P）调出命令面板，执行Java: Clean Java Language Server Workspace，在弹出的确认框里选择重启，等待Java语言服务重新加载项目后再尝试启动。
• 校验Gradle导入配置
  打开VSCode设置面板，搜索java.import.gradle，确认Gradle导入开关处于开启状态；如果本地Gradle Wrapper文件损坏，直接指定本地已安装的同版本Gradle路径，不要使用默认的Wrapper配置。修改完成后同样执行清理Java语言服务器工作区的操作重启服务。
• 手动在launch.json中指定类路径，跳过自动解析
  打开项目.vscode目录下的launch.json，在对应启动配置项中添加classPaths字段，直接写入编译输出路径和依赖路径，参考配置：

  {
      "configurations": [
          {
              "type": "java",
              "name": "Spring Boot-SigprojApplication<sigproj-backend>",
              "request": "launch",
              "cwd": "${workspaceFolder}",
              "mainClass": "com.sti.sigproj.SigprojApplication",
              "projectName": "sigproj-backend",
              "args": "",
              "envFile": "${workspaceFolder}/.env",
              "classPaths": [
                  "${workspaceFolder}/bin/main",
                  "${userHome}/.gradle/caches/modules-2/files-2.1/**/*.jar"
              ]
          }
      ]
  }
  

  如果通配符匹配依赖失败，先在项目根目录终端执行gradle dependencies列出所有依赖包路径，把所有依赖的绝对路径逐个填入classPaths数组即可。
• 校验JDK版本匹配
  项目指定使用Java 8，打开VSCode设置搜索java.configuration.runtimes，确认JavaSE-1.8对应的路径是本地安装的JDK8完整路径，不要使用JDK11及以上版本作为该项目的运行时，避免JPMS模块系统导致的类路径解析异常。
• 重置项目元数据
  关闭VSCode，直接删除项目根目录下的.vscode、.settings文件夹，以及.classpath、.project元数据文件，重新打开VSCode后等待Gradle插件自动完成项目导入，生成正确的配置文件，不要手动修改自动生成的类路径配置。
• 先确认命令行构建正常
  在项目根目录终端执行gradle build，确认命令行下构建可以正常完成，没有依赖下载失败、编译报错的问题。如果命令行构建本身失败，先解决构建阶段的问题，Java语言服务器才能正确解析类路径。

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