Gradle执行javadoc任务生成Android项目Javadoc失败报错咨询

当前Javadoc任务的类路径仅配置了Android SDK基础boot路径，未纳入项目编译依赖的AndroidX组件、第三方库等依赖，因此触发类符号找不到的报错；kotlin-android-extensions插件废弃警告为独立提示，不会直接导致Javadoc生成失败，可按官方迁移方案处理消除警告。

1. 修正Javadoc任务配置 #

替换模块级build.gradle中原有Javadoc任务配置，补全类路径与源码目录配置：

task javadoc(type: Javadoc) {
    // 覆盖Java、Kotlin混编项目的源码路径
    source = android.sourceSets.main.java.srcDirs
    def kotlinSrcPaths = android.sourceSets.main.java.srcDirs.collect {
        it.path.replace("java", "kotlin")
    }
    source += files(kotlinSrcPaths)

    // 核心修复：将所有编译期依赖（含AndroidX、第三方库、模块依赖）加入Javadoc类路径
    android.applicationVariants.all { variant ->
        classpath += variant.javaCompileProvider.get().classpath
    }
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))

    // 保持原有输出目录配置
    destinationDir = file("../docs")

    // 可选容错配置：避免注释格式问题中断生成
    options {
        encoding "UTF-8"
        charSet "UTF-8"
        addStringOption("Xdoclint:none", "-quiet")
        failOnError false
    }
}

2. 消除kotlin-android-extensions废弃警告 #

• 打开模块级build.gradle的plugins配置块，删除id 'kotlin-android-extensions'行
• 若原有代码使用该插件提供的Kotlin合成属性引用View，迁移至View Binding；若使用该插件的Parcelable序列化能力，新增id 'kotlin-parcelize'插件即可，原有@Parcelize注解无需修改即可正常生效。

3. 执行生成验证 #

先执行./gradlew clean清理旧构建缓存，再执行./gradlew javadoc重新生成文档，生成完成后可在配置的../docs目录下查看输出的Javadoc文件。

• 若项目为纯Java项目，可省略配置中Kotlin源码路径的相关代码
• 若存在compileOnly引入的依赖，需手动将对应依赖加入Javadoc任务的classpath配置，这类依赖不会被自动纳入编译类路径
• 多模块项目需将依赖的library模块的源码路径、类路径同步加入当前Javadoc任务配置，否则会出现跨模块类找不到的报错

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