使用exec-maven-plugin运行Maven项目时资源配置失效、系统类加载器无法加载自定义资源的问题

前置项目配置背景 #

• 在pom.xml中显式声明两个目录为项目资源路径：src/main/sql、src/main/resources
• 引入3.0.0版本的exec-maven-plugin，配置id为RunMyTest的执行任务，任务逻辑为运行src/test/java目录下的com.foo.RunMyTest类，设置classpathScope为test，同时在插件配置块中声明addResourcesToClassPath=true

表层问题：插件参数配置未被识别生效 #

执行mvn -X exec:java@RunMyTest命令启动任务时，插件调试日志显示实际加载的addResourcesToClasspath属性值为false，与pom中配置的预期值不符，即声明的配置没有被插件正确读取。
后续通过命令行参数-DaddResourcesToClasspath=true临时覆盖配置后，调试日志显示参数值已符合预期，配置生效。

核心问题：系统类加载器无法读取自定义资源路径下的资源 #

在参数生效后，出现两类矛盾的资源读取表现：

• 项目依赖的组件调用ClassLoader.getSystemClassLoader().getResource("foo.txt")，读取存放在src/main/sql目录下的foo.txt资源时，返回值为null
• 同一个资源文件，在当前RunMyTest测试类内部，通过RunMyTest.class.getClassLoader().getResource("foo.txt")却能正常读取到对应内容
• 根因定位：exec-maven-plugin在exec:java模式下，会构建自定义类加载器来加载项目类路径下的类与资源，但不会将该自定义类加载器设置为JVM的系统类加载器，导致系统类加载器的扫描路径中完全没有纳入项目自定义的资源路径，依赖组件通过系统类加载器读资源时自然找不到目标文件。

可落地优化方案 #

• 修复插件参数不生效的问题
  核对3.0.0版本exec-maven-plugin的官方参数命名规则：该版本对应参数的实际名称为addResourcesToClasspath（末尾p为小写，非驼峰格式addResourcesToClassPath）。pom中因参数名拼写与官方定义不匹配，配置属于无法被插件识别的冗余项，因此始终取插件默认的false值。将pom中的参数名修正为与官方定义一致的拼写后，即可避免每次执行时通过命令行参数手动覆盖的问题。
• 解决系统类加载器资源读取失败的问题
  1. 调整插件系统属性配置：在插件执行任务的systemProperties块中，手动拼接java.class.path系统属性值，将src/main/sql、src/main/resources对应的构建输出资源目录，追加到原有系统类路径值的末尾，让系统类加载器可以扫描到这些资源路径。
  2. 前置手动追加类路径：如果无法修改插件配置，可以在RunMyTest类的main方法最开头、执行任何业务逻辑之前，通过反射操作修改系统类加载器的类路径扫描范围，将两个自定义资源目录手动追加到URL类加载器的扫描路径中。
  3. 切换插件执行模式：将当前的exec:java执行模式替换为exec:exec模式，Fork出独立的Java子进程，手动配置子进程的-classpath参数，将所有项目资源目录、依赖Jar包路径完整传入。这种模式下子进程的系统类加载器会直接加载传入的全量类路径，不存在自定义类加载器与系统类加载器的路径隔离问题。

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