Android多模块项目构建失败，抛出TypeNotPresentException异常

结合你的项目情况——16个多模块（多数为Java模块）、包含注解处理逻辑、指定Java 8作为目标版本、通过自定义DynamicDeps插件动态添加依赖，我整理了几个高概率的排查方向和解决办法：

1. 动态依赖未覆盖注解处理器的类路径需求 #

你的DynamicDeps插件目前只添加了runtimeOnly和implementation类型的依赖，但注解处理器在编译阶段依赖的类是从annotationProcessor或compileOnly配置中获取的，runtimeOnly依赖不会参与编译时的类路径扫描。如果你的注解处理器需要某些依赖才能正常运行，就会因为找不到类抛出TypeNotPresentException。

解决办法：
检查你的注解处理器依赖是否缺失，在DynamicDeps插件中补充对应的annotationProcessor或compileOnly依赖，比如：

class DynamicDeps implements Plugin<Project> {
    @Override
    void apply(Project target) {
        target.dependencies {
            // 原有依赖
            implementation 'com.example:core:1.0.0'
            runtimeOnly 'com.example:runtime:1.0.0'
            // 新增注解处理器依赖（如果需要）
            annotationProcessor 'com.example:processor:1.0.0'
        }
    }
}

2. 模块间Java 8配置不一致 #

虽然你说项目指定了Java 1.8作为目标版本，但如果某个模块（尤其是包含注解处理的模块）没有明确配置sourceCompatibility和targetCompatibility，可能会导致编译时的类版本不兼容，间接引发类找不到的异常。

解决办法：
确保所有模块都统一配置Java 8：

• 对于Android模块：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    // 如果用Kotlin，还要补充Kotlin配置
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

• 对于纯Java模块：

java {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
}

3. 注解处理器生成的类未被正确识别或缓存问题 #

如果你的模块包含注解处理逻辑，生成的类可能因为构建缓存残留、输出目录未被正确暴露，导致其他模块编译时找不到这些类。

解决办法：

• 先清理构建缓存，执行命令：

./gradlew clean

然后重新构建项目，排除缓存导致的旧类残留问题。

• 检查注解处理器模块的依赖声明：如果其他模块需要使用该模块生成的类，要把依赖类型从implementation改成api，确保生成的类能被下游模块访问到。

4. 自定义插件的依赖添加时机错误 #

如果DynamicDeps插件的依赖添加逻辑执行时机太晚（比如在执行阶段而非配置阶段），会导致Gradle在计算编译类路径时没有包含这些动态添加的依赖，最终引发类找不到的异常。

解决办法：
确保插件在配置阶段就完成依赖添加，不要放到afterEvaluate或任务执行逻辑里。比如直接在apply方法中配置依赖，就像上面示例那样；如果需要基于某些条件添加依赖，也要在配置阶段完成判断。

5. 缺失可选依赖导致类找不到 #

有些第三方库会引用可选依赖，这些依赖不会被自动引入，如果你的动态插件漏掉了这些可选依赖，就会在编译或运行时抛出TypeNotPresentException。

解决办法：
查看异常栈信息，找到具体缺失的类名，搜索该类所属的依赖包，然后在DynamicDeps插件中添加对应的依赖。比如如果缺失的是com.google.common.base.Optional，就需要添加Guava的依赖。

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