Java可正常编译但Kotlin报错：无法访问接口超类型的技术咨询

我有两个存在依赖关系的库：

Lib1 - Lib1.java #

package com.example.lib1;

public interface Lib1 {
}

Lib2 - Lib2.java #

Lib2的Gradle依赖配置为implementation "com.example:lib1:1.0.0"，代码如下：

package com.example.lib2;

import com.example.lib1.Lib1;

public interface Lib2 extends Lib1 {
    String hello = "Hello";
}

应用端代码 #

使用Lib2的应用中，Java类可正常编译：

package com.example.libtest;

import com.example.lib2.Lib2;

public class TestJava {
    public String hello = Lib2.hello;
}

但Kotlin类编译报错：

package com.example.libtest

import com.example.lib2.Lib2

fun test() {
    val x = Lib2.hello; // 错误位置
}

错误信息：Cannot access 'com.example.lib1.Lib1' which is a supertype of 'com.example.lib2.Lib2'. Check your module classpath for missing or conflicting dependencies

将Lib2的Gradle依赖改为api后，Kotlin文件可正常编译。

疑问 #

1. 我理解api会暴露传递依赖，但为何使用implementation时Java类可正常编译，而Kotlin报错？
2. 此处是否必须使用api？Lib1本应对应用隐藏才对？

环境信息：Java 11、AGP 7.3.1、Gradle 7.4、应用中使用的Kotlin版本为1.7.20。

问题1：Java与Kotlin编译行为差异的原因 #

核心是两者编译器对公共API中父类型依赖的处理逻辑不同：

• Java编译器处理Lib2.hello时，会直接读取这个常量的字面量值（Java接口的静态常量会被编译期内联），不需要加载Lib1的字节码就能完成编译。哪怕Lib1不在类路径上，只要能拿到Lib2里hello的具体值，Java就不会报错。
• Kotlin编译器的校验更严格：它解析Lib2时会递归检查所有父类型的可达性。因为Lib2继承自Lib1，而implementation依赖会把Lib1藏在Lib2的内部类路径中，应用模块访问不到Lib1的字节码，所以Kotlin会判定父类型不可达，抛出错误。

简单说，Java是“只拿需要的常量值”，Kotlin是“先确保整个类型继承链完整”。

问题2：是否必须使用api？ #

不是必须，有更优的方案可以兼顾依赖隐藏和编译正常：

方案1：保留implementation，修改Lib2代码 #

如果想继续隐藏Lib1，可以调整Lib2的结构：把接口改成类，或者把常量移到独立的静态类中，比如：

// 修改后的Lib2.java
package com.example.lib2;

import com.example.lib1.Lib1;

public class Lib2 implements Lib1 {
    public static final String hello = "Hello";
}

这样Kotlin访问Lib2.hello时，只会识别为类的静态成员，不需要解析Lib1的继承关系，编译就能正常通过，同时Lib1依然被implementation隐藏，符合你的设计需求。

方案2：使用api（不推荐，除非必要） #

只有当应用模块确实需要直接使用Lib1时，才需要用api。如果只是为了访问Lib2的常量就用api，会不必要地暴露Lib1，破坏依赖隐藏的设计。

所以最优解是调整Lib2的代码结构，既保留依赖隐藏特性，又兼容Kotlin的编译逻辑。

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