Android Studio生成JavaDoc抛出NullPointerException无法识别Android类求助

根因说明 #

报错核心由两个问题共同导致：

1. Javadoc执行时未将Android SDK中的android.jar纳入类路径，无法识别Android系统组件类，最终触发空指针异常
2. Java 11及以上版本已废弃-bootclasspath参数，旧的兼容方案失效

通用解决方案 #

方案1：Android Studio GUI生成时临时配置 #

在JavaDoc生成对话框的「其他命令行参数」输入框中，替换废弃的-bootclasspath参数，改用--class-path参数指定对应版本android.jar的路径：

--class-path /path/to/your/Android/sdk/platforms/android-xx/android.jar

路径替换说明：

• 把/path/to/your/Android/sdk替换为本地Android SDK的实际安装路径
• 把android-xx替换为项目compileSdk对应的版本号
• Linux/macOS下多路径用冒号分隔，Windows下用分号分隔

方案2：Gradle任务配置（推荐，适合多类/多依赖项目） #

直接在项目app模块的build.gradle文件中添加专用Javadoc生成任务，一次配置永久生效：

android.javadocOptions {
    // 非致命错误不中断生成流程
    failOnError false
    // 引入Android SDK基础类路径
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
    // 引入项目所有第三方依赖的类路径
    classpath += configurations.compileClasspath
}

task generateJavadoc(type: Javadoc) {
    // 指定要生成文档的源码目录
    source = android.sourceSets.main.java.srcDirs
    // 复用全局类路径配置
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
    classpath += configurations.compileClasspath
    // 文档输出路径
    destinationDir = file("${project.buildDir}/docs/javadoc")
    // 过滤不需要生成文档的自动生成类
    exclude '**/R.*', '**/BuildConfig.*'
}

配置完成后，打开Android Studio右侧的Gradle面板，依次进入app -> Tasks -> documentation -> generateJavadoc，双击执行任务即可，生成的文档默认保存在app/build/docs/javadoc目录下。

注意事项 #

• 上述方案仅适用纯Java项目，Kotlin混编项目生成文档请使用官方dokka插件
• 执行任务前请确认项目compileSdk版本与本地SDK安装的对应版本一致

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