如何在Java库中使用Kotlin，且不强制消费者依赖Kotlin Stdlib？

可以实现你的需求，核心是通过依赖隔离和代码着色/重定位两个手段，既用Kotlin开发库的内部逻辑，又不会给消费者强加依赖或引发类路径冲突。以下是具体实现方案：

一、基础配置：避免传递Kotlin依赖 #

首先确保Kotlin相关依赖不会自动传递给库的消费者，这一步是基础：

Maven 配置 #

将Kotlin标准库等依赖标记为<optional>true</optional>，这样消费者在引入你的库时，不会自动引入Kotlin依赖：

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-stdlib-jdk8</artifactId>
        <version>你的Kotlin版本</version>
        <optional>true</optional>
    </dependency>
    <!-- 如果用到Kotlin反射等其他依赖，同样设置为optional -->
</dependencies>

Gradle 配置 #

使用implementation配置声明Kotlin依赖，而非api——implementation的依赖只会用于库内部编译，不会传递给消费者：

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:你的Kotlin版本"
    // 其他Kotlin相关依赖同理用implementation
}

二、进阶：着色/重定位Kotlin标准库（解决冲突问题） #

如果要彻底避免与消费者的Kotlin版本冲突，着色（Shading）/重定位（Relocation）是可行方案，尽管Kotlin编译器对标准库有特殊处理，但只要正确配置就能规避问题：

核心原理 #

将你使用的Kotlin标准库的包路径全部重命名（比如把kotlin.*改成com.yourlibrary.kotlin.*），并打包进自己的库jar中。这样你的库会使用独立的、重命名后的Kotlin标准库，完全不与消费者的Kotlin版本产生冲突。

Maven 实现（用maven-shade-plugin） #

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <!-- 重定位Kotlin包 -->
                <relocations>
                    <relocation>
                        <pattern>kotlin</pattern>
                        <shadedPattern>com.yourlibrary.kotlin</shadedPattern>
                    </relocation>
                    <relocation>
                        <pattern>kotlinx</pattern>
                        <shadedPattern>com.yourlibrary.kotlinx</shadedPattern>
                    </relocation>
                </relocations>
                <!-- 指定要着色的Kotlin依赖 -->
                <artifactSet>
                    <includes>
                        <include>org.jetbrains.kotlin:kotlin-stdlib-jdk8</include>
                        <!-- 如果用到其他Kotlin依赖，比如kotlin-reflect，添加在这里 -->
                    </includes>
                </artifactSet>
            </configuration>
        </execution>
    </executions>
</plugin>

配置后，执行mvn package会生成一个包含重定位后Kotlin标准库的jar包，此时无需再将Kotlin依赖设为optional。

Gradle 实现（用Shadow插件） #

首先引入Shadow插件：

plugins {
    id 'java'
    id 'org.jetbrains.kotlin.jvm' version '你的Kotlin版本'
    id 'com.github.johnrengelman.shadow' version '8.1.1'
}

然后配置重定位和打包规则：

shadowJar {
    // 重定位Kotlin包路径
    relocate 'kotlin', 'com.yourlibrary.kotlin'
    relocate 'kotlinx', 'com.yourlibrary.kotlinx'
    
    // 指定要打包的Kotlin依赖
    dependencies {
        include(dependency('org.jetbrains.kotlin:kotlin-stdlib-jdk8'))
    }
    
    // 生成的jar包命名可以自定义，比如保留原jar名加-shadow后缀
    archiveClassifier.set('shadow')
}

// 让build任务自动触发shadowJar，构建时直接生成着色后的jar
build.dependsOn(shadowJar)

三、注意事项 #

1. API暴露限制：如果你的库对外暴露的API全部是Java类型，消费者完全不需要感知Kotlin的存在；如果必须暴露Kotlin类型，建议尽量避免，否则消费者仍需引入Kotlin依赖（但此时因为你用了重定位，不会和他们的版本冲突）。
2. 内联函数问题：Kotlin内联函数的代码会被插入到调用处，如果你的内联函数引用了Kotlin标准库API，且这些函数是public的，可能会导致消费者代码引用未重定位的标准库。因此建议仅在库内部使用内联函数，或避免在公开内联函数中直接调用标准库API。
3. 测试验证：打包后务必测试，确保重定位后的类能正常加载，且与不同版本的Kotlin标准库共存时无冲突。

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