Gradle多项目构建失败：子项目B缺失仅A使用的依赖X

问题背景 #

• 开发Gradle多项目，子项目A声明并使用依赖X
• 子项目B依赖子项目A，但构建:subprojectB:compileJava失败，提示缺少依赖X中的SomeClass

错误信息（编辑1） #

C:\...\ClassSubpojectB.java:86: error: cannot access SomeClass
      //some code
                          ^
  class file for SomeClass not found
1 error

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':subprojectB:compileJava'.
> Compilation failed; see the compiler error output for details.

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 1m 53s

代码细节（编辑2） #

子项目B中调用代码：

Bla bla = Dao.get(Bla.class, new Key("id", id));

子项目A中Dao.get方法实现：

public static <O> O get(Class<O> c, Key key) {
  SomeClass s = key.getSomeClass();
  return get(c, s);
}

疑问：SomeClass仅在方法内部使用，理论上不应被暴露，为何会导致子项目B编译失败？

问题原因与解决方案 #

原因 #

Java编译时会解析所有方法签名涉及的类型，以及这些类型的传递依赖类型。虽然SomeClass在Dao.get内部使用，但Key类的getSomeClass()方法返回SomeClass类型——子项目B调用Dao.get时，编译器需要确认Key类所有公开方法的返回类型是可访问的，因此SomeClass必须出现在子项目B的编译类路径中，哪怕子项目B没直接使用它。

解决方案 #

1. 调整依赖传递范围：在子项目A的build.gradle中，把依赖X的范围从implementation改成api，这样依赖会传递给子项目B：

   // 子项目A的build.gradle
   dependencies {
       api 'xxx:X:版本号' // 替换原有的implementation声明
   }
   

2. 封装隐藏依赖：修改代码结构，避免对外暴露SomeClass：
   • 把Key类的getSomeClass()方法改成包私有（去掉public修饰符），同时让Dao类和Key类处于同一包下；
   • 重载Dao.get方法，给子项目B提供一个无需传入Key的版本，内部自行处理Key和SomeClass的逻辑。

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