多模块项目中ServiceLoader无法找到Provider实现类问题咨询

编译后未生成jar包不是故障诱因。ServiceLoader 扫描的是运行时类路径下的资源，不管资源存放在解压的编译输出目录还是jar包中，只要类路径配置正确就能正常读取，不需要强制打包为jar。

核心故障原因与修复方案 #

加载失败本质是JVM在运行时没有找到对应服务配置、或者无法实例化配置中声明的实现类，按优先级排查以下问题即可：

• 运行时类路径缺失Version1、Version2模块的编译输出
  项目能正常编译仅代表编译阶段的依赖配置正确，不代表运行EntryPoint主函数时，JVM类路径包含了两个实现模块的编译产物。
  修复方式：
  • 若通过IDE直接运行main函数，打开运行配置的Classpath选项，手动将Version1、Version2模块的main编译输出目录加入运行时类路径；
  • 若通过Gradle/Maven等构建工具运行，在EntryPoint模块中声明对两个实现模块的运行时依赖即可，以Gradle为例：

    // EntryPoint模块的build.gradle配置
    dependencies {
        implementation project(':Library')
        runtimeOnly project(':Version1')
        runtimeOnly project(':Version2')
    }
    

• 服务配置或实现类不符合SPI规范
  逐一核对以下规则，任意一条不满足都会导致加载失败：
  1. META-INF/services/下的配置文件名必须是Parent接口的全限定类名，包名、类名、大小写完全和接口定义一致，不能有拼写错误；
  2. 配置文件内填写的实现类全限定名必须和Version1、Version2中Impl类的实际包名、类名完全一致；
  3. Impl类必须是public修饰（Kotlin中默认是public，若显式加了internal/private修饰会跨模块访问失败），不能是抽象类或接口，且必须提供无参构造方法（Kotlin类若定义了带参构造，必须额外保留无参构造或给所有参数加默认值，否则ServiceLoader无法实例化类）。
• 资源文件输出路径错误
  确认build目录下的服务配置文件最终输出位置在类路径根的META-INF/services/下，没有嵌套多余目录。比如正确的输出路径为build/resources/main/META-INF/services/[接口全限定名]时，只要build/resources/main被设为类路径根就能正常读取；如果输出路径多套了一层目录（比如build/resources/main/resources/META-INF/services/xxx），说明模块的资源目录配置错误，ServiceLoader无法扫描到。

快速定位方法 #

在main函数开头加入调试代码，直接打印类加载器能找到的所有服务配置文件路径，就能快速定位问题：

fun main(args: Array<String>){
    // 调试代码：打印所有找到的服务配置
    val configPath = "META-INF/services/${Parent::class.java.name}"
    println("当前扫描的服务配置路径: $configPath")
    Parent::class.java.classLoader.getResources(configPath).asIterator().forEachRemaining { url ->
        println("找到服务配置: $url")
    }

    val impls = ServiceLoader.load(Parent::class.java)
    val implToUse = impls.find { i -> i.getName() == args[0]}
    implToUse!!.doSomething()
}

运行后如果控制台没有输出任何「找到服务配置」的日志，直接排查运行时类路径是否包含两个实现模块；如果能找到配置文件但仍加载失败，核对配置里的类名、Impl类的修饰符和构造方法即可。

注：你贴出的代码中main函数参数写法args<String>是Kotlin语法错误，正确写法为args: Array<String>，如果是笔误忽略即可。

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