排查Java/JavaFX调试时ClassNotFoundException及调试器故障

我正在开发一个用于培训的小型Java/JavaFX应用，应用能正常运行，但启动调试时，调试器触发了ClassNotFoundException，且未提示具体缺失的类。调试器停在BuiltinClassLoader处，对应的类对象为null，不知从何入手排查，恳请提供恢复调试功能的排查方法。

环境信息 #

• IntelliJ IDEA 2022.2.3（社区版）
  • Build #IC-222.4345.14，构建于2022年10月5日
  • Runtime版本：17.0.4.1+7-b469.62 amd64
  • VM：JetBrains s.r.o.提供的OpenJDK 64-Bit Server VM
• 操作系统：Windows 11 10.0
• GC：G1 Young Generation, G1 Old Generation
• 内存：2048M
• 核心数：32
• Kotlin：222-1.7.10-release-334-IJ4345.14
• JDK版本：java 19.0.1 2022-10-18
  • Java(TM) SE Runtime Environment（版本19.0.1+10-21）
  • Java HotSpot(TM) 64-Bit Server VM（版本19.0.1+10-21，混合模式，共享）

排查策略 #

1. 核对调试与运行配置的一致性 #

• 打开Run/Debug Configurations，确认调试配置的Classpath、Module设置和正常运行的配置完全一致，避免调试时使用了不同的类路径
• 若项目中有标记为Provided的依赖，勾选配置中的Include dependencies with "Provided" scope选项，防止调试时遗漏依赖类

2. 清理项目编译缓存并重建 #

• 执行Build > Clean Project，再执行Build > Rebuild Project，确保所有类文件都被重新编译
• 删除项目根目录下的.idea文件夹和out目录，重启IntelliJ后重新导入项目，重置IDE的缓存和配置

3. 统一JDK版本配置 #

• 检查IntelliJ的Project SDK、Module SDK以及调试配置中使用的JDK版本是否一致（当前环境中IDE运行时用JDK17，项目用JDK19，可能存在兼容性问题）
• 尝试将项目JDK切换为IntelliJ自带的JDK17，测试调试功能是否恢复正常

4. 启用类加载详细日志 #

• 打开Help > Edit Custom VM Options，添加以下参数以输出类加载的详细日志：

  -Dsun.misc.URLClassPath.debug=true
  -Djava.net.debug=all
  -Djdk.internal.loader.ClassLoader.debug=true
  

  重启IDE后启动调试，通过控制台日志定位加载失败的具体类

5. 检查JavaFX模块配置 #

• 确认module-info.java中已正确声明所有依赖的JavaFX模块，示例配置：

  module your.module.name {
      requires javafx.controls;
      requires javafx.fxml;
      opens your.package.name to javafx.fxml;
      exports your.package.name;
  }
  

• 若为模块化项目，确保调试配置的VM参数中正确设置了JavaFX模块路径和所需模块：

  --module-path "path/to/javafx-sdk/lib" --add-modules javafx.controls,javafx.fxml
  

6. 排查插件冲突 #

• 暂时禁用所有第三方插件（保留Kotlin核心插件），重启IDE后测试调试功能，排查是否因插件干扰导致调试异常

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