执行Gradle命令失败：javax.annotation包不存在

问题根因 #

IntelliJ IDEA会自动将javax.annotation相关类加入项目类路径，所以在IDE内构建、测试都正常；但Gradle命令行构建时不会自动引入这个包，即便使用JDK 8，也需要显式添加依赖。

修复步骤 #

在项目的build.gradle文件中添加对应的依赖：

• 如果是主代码需要，添加编译期依赖：

dependencies {
    // 保留原有依赖，新增下面这行
    compileOnly 'javax.annotation:javax.annotation-api:1.3.2'
}

• 如果是测试代码需要，添加测试编译期依赖：

dependencies {
    // 保留原有依赖，新增下面这行
    testCompileOnly 'javax.annotation:javax.annotation-api:1.3.2'
}

验证 #

执行以下命令重新构建或测试，确认错误消失：

# 清理并完整构建
./gradlew clean build

# 仅运行测试
./gradlew test

内容的提问来源于stack exchange，提问作者dev-rifaii