IntelliJ运行Maven应用时字节码选择逻辑及调试问题咨询

问题场景 #

使用IntelliJ运行和调试基于Maven构建的Java可执行Jar应用（通过maven-assembly-plugin打包，非SpringBoot项目）时，遇到以下问题：

• IntelliJ选择的字节码与maven-assembly-plugin打包的不一致
• 修改依赖版本（如loglib:2.1.0-SNAPSHOT）后，IntelliJ未加载更新后的代码
• 调试时显示的源码与实际执行的字节码不匹配

针对上述场景，解答以下核心问题：

1. IntelliJ调试时如何选择要使用的字节码？ #

• 默认优先使用项目编译目录（target/classes 或 target/test-classes）下的字节码，而非Maven插件打包生成的Jar内的字节码。
• 若要指定使用Maven打包后的Jar，需在Run/Debug Configuration中配置：选择"Application"类型，将"Use classpath of module"改为手动指定Jar文件，或在"VM options"中通过 -cp 参数指定Jar路径。
• 也可在Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Runner中，勾选"Delegate IDE build/run actions to Maven"，让IntelliJ完全委托Maven处理构建，此时会使用Maven生成的字节码。

2. IntelliJ是直接使用Maven构建插件还是模拟其行为？ #

• 默认用自身构建引擎模拟Maven的构建逻辑，而非直接调用Maven插件。这种模拟在依赖打包、资源过滤等场景可能和Maven原生构建存在差异。
• 若开启"Delegate IDE build/run actions to Maven"选项，IntelliJ会直接调用Maven命令（如mvn compile、mvn package）执行构建，完全复用Maven插件的行为。

3. 存在依赖版本冲突时，IntelliJ如何选择代码版本？ #

• 遵循Maven的依赖调解规则：优先选择路径最短的依赖；路径长度相同时，优先选择pom.xml中声明顺序靠前的依赖。
• 可通过IntelliJ的Maven Projects面板 -> "Dependencies" -> 右键点击依赖 -> "Show Dependency Diagram"查看依赖树，确认冲突版本的选择逻辑。
• 若未委托Maven构建，IDE自身的依赖解析逻辑和Maven保持一致，但需确保IDE的Maven配置（Settings -> Build, Execution, Deployment -> Build Tools -> Maven）和本地Maven环境一致。

4. IntelliJ生成的JAR文件位置在哪里，以便检查所用类版本？ #

• 若用IntelliJ自身构建生成Jar，默认路径为 项目根目录/out/artifacts/[模块名]_jar/[Jar文件名]。
• 若开启委托Maven构建，Jar文件位置和Maven插件配置一致，通常为 项目根目录/target/[Jar文件名]。
• 也可通过Run/Debug Configuration中的"Output directory"字段查看具体生成路径。

5. 运行与调试时的类选择逻辑是否有差异？ #

• 运行和调试的类选择逻辑本质一致，都基于当前配置的类路径：默认使用IDE编译的target目录，或委托Maven后的Maven构建产物。
• 差异仅在于调试时会加载源码映射信息（.class对应.java文件），若源码和字节码版本不匹配，会出现调试显示源码与实际执行不符的情况，但类文件本身的选择逻辑和运行时相同。

6. 调试显示源码与实际执行字节码不符时，如何追踪实际使用的代码？ #

• 打开IntelliJ的Run -> Show Execution Data -> Classes，查看当前进程加载的类的来源路径，确认是来自IDE编译目录还是Maven打包的Jar。
• 使用jps命令找到进程ID，再用jmap -histo [PID]或jcmd [PID] VM.class_hierarchy查看类的加载信息，定位具体类的来源Jar或目录。
• 调试时，右键点击断点处的代码 -> "Show Bytecode"，对比字节码和当前显示的源码是否一致；若不一致，可通过File -> Project Structure -> Libraries检查对应的依赖库版本是否正确，或重新关联源码。

问题复现步骤 #

• 克隆maven-shade-example项目，切换至feature/fixing-problem-another-way分支。
• 执行mvn clean install，用java -jar target/[Jar文件名].jar运行Jar，确认运行正常。
• 在IntelliJ中直接运行该项目，会抛出NoSuchMethodError异常，即可复现类版本不一致问题。

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