多模块Android项目创建HomeFragment报Supertypes无法解析，Navigation Component正常？

核心原因 #

Gradle依赖的传递性配置差异，以及编译阶段与运行阶段的类解析机制不同

直接实例化报错的原因 #

你当前的依赖配置存在传递性问题：

• :features:home 模块使用 implementation 依赖 :commons:ui
• :app 模块使用 implementation 依赖 :features:home

Gradle的 implementation 依赖有明确的特性：依赖的类库不会传递到依赖当前模块的其他模块的编译类路径中。也就是说，:app 模块的编译阶段只能访问到 :features:home 自身的类，以及 :features:home 用 api 声明的依赖类，commons:ui 中的 BaseFragment 完全不在 :app 的编译类路径里。

当你在 MainActivity 中直接写 HomeFragment() 时，编译器需要解析 HomeFragment 的完整继承链，才能通过编译校验。此时编译器在类路径中找不到它的父类 tech.vrutal.ui.BaseFragment，就会抛出「无法解析父类」的错误。

Navigation组件可正常运行的原因 #

Navigation的配置逻辑完全绕开了编译阶段的类结构校验：

• 你在 nav_graph.xml 中用字符串形式声明 HomeFragment 的全限定类名：android:name="tech.vrutal.home.HomeFragment"
• 编译阶段，:app 模块的编译器只会把这段字符串作为普通XML资源处理，不会主动加载、解析这个类的继承结构，因此不会触发父类校验。
• 运行阶段，NavHostFragment 会通过反射机制，从应用全局的类加载路径中查找并实例化 HomeFragment。而APK打包时会把所有依赖模块（包括所有 implementation 依赖的模块）的类合并到最终的Dex文件中，此时全局类加载路径中存在 BaseFragment，反射实例化可以正常完成，因此不会报错。

解决方法 #

如果需要支持直接实例化 HomeFragment，可以二选一调整依赖配置：

1. 修改 :features:home 的构建配置，将对 :commons:ui 的依赖从 implementation 改为 api：

// :features:home/build.gradle
dependencies {
    // 原配置：implementation project(':commons:ui')
    api project(':commons:ui')
}

该配置会将 :commons:ui 的类传递到所有依赖 :features:home 模块的编译类路径中。
2. 或者在 :app 模块中显式添加对 :commons:ui 的依赖：

// :app/build.gradle
dependencies {
    implementation project(':features:home')
    implementation project(':commons:ui')
}

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