IntelliJ调试无法单步进入运行时生成Java类的解决方案咨询

核心问题是IDEA的调试器需要在类加载前完成源文件、class文件的索引和路径匹配，默认配置下运行过程中新增的文件不会被实时索引，才会出现当次运行无法匹配栈帧、重启后扫描到文件就能调试的现象，可通过以下配置解决：

一、基础路径与编译参数配置 #

• 动态生成的.java源文件、编译输出的.class文件必须存放在当前模块已标记的源码根、编译输出根目录下，禁止存放到系统临时目录、未关联的自定义目录。以Maven项目为例，源文件按包结构放到src/main/java对应路径，class文件输出到target/classes对应包路径，和项目普通编译产物保持同层级。
• 动态编译时必须携带-g参数生成完整调试信息，否则IDEA无法匹配行号实现单步，JavaCompiler调用示例：

// 编译参数：-g生成全量调试信息，-d指定class输出路径，-sourcepath指定源码查找路径
Iterable<String> compileOptions = Arrays.asList("-g", "-d", CLASS_OUTPUT_ROOT, "-sourcepath", SOURCE_OUTPUT_ROOT);
JavaCompiler.CompilationTask task = compiler.getTask(null, standardJavaFileManager, null, compileOptions, null, compilationUnits);
task.call();

• 进入Project Structure -> Modules配置页，确认动态源码存放目录标记为Sources（蓝色文件夹标识），编译输出目录不要加入排除索引列表。

二、IDEA实时索引配置 #

• 打开Settings -> Build, Execution, Deployment -> Compiler，勾选Make project automatically选项，关闭不必要的并行编译配置避免生成文件被覆盖。
• 打开Settings -> Advanced Settings，勾选Allow auto-make to start even if developed application is currently running，允许程序运行过程中自动触发编译、索引新增的源文件。

三、运行时调试适配操作 #

• 自定义类加载器加载动态类时，不要重写资源查找方法屏蔽源码路径定位，必须保证类加载器可正确返回生成源文件、class文件的资源地址，IDEA调试器依赖类加载器的资源查找能力匹配源码位置。
• 在动态类的方法调用前打一个断点，程序停在该断点时，右键点击调试面板的当前线程，选择Reload Changed Classes手动触发变更类重载，无需重启IDE即可让调试器匹配到刚生成的源码和字节码，支持单步进入、变量查看等全量调试操作。
• 如果还是无法识别，手动点击IDEA对应构建工具（Maven/Gradle）面板的刷新按钮，触发一次全项目文件扫描即可，不需要重启IDE。

注意：很多人遇到这个问题的核心诱因是把动态生成的文件存到了系统临时目录，IDEA默认不会索引这类非项目关联路径的文件，就算类被JVM加载，调试器也找不到对应源码做匹配。

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