在Gradle PMD类路径添加第三方Jar引发ClassNotFoundException问题

安全阿岳

2026-8-1

问题与解决方案

问题描述

尝试在Gradle中添加AspectJ依赖时使用了以下写法：

dependencies {
    pmd fileTree(dir: "${lib}/aspectj-1.9.4", includes: ['*.jar'])
     
    // OR below
   
    // pmd 'org.aspectj:aspectjtools:1.9.4'

    // OR even below also causes same problem.

    // pmdAux 'org.aspectj:aspectjtools:1.9.4'
}

运行时触发错误：java.lang.ClassNotFoundException: net.sourceforge.pmd.PMD

问题原因

依赖配置位置错误：PMD属于Gradle构建脚本层面的插件，其依赖不能放在项目的普通dependencies块中，必须配置在buildscript的classpath里——普通dependencies是给项目业务代码提供依赖的，而构建脚本自身的依赖需要通过buildscript来声明。
依赖配置语法错误：pmd、pmdAux并非Gradle标准的依赖配置项，这样的写法无法让Gradle正确识别并加载PMD相关依赖。

解决方法

方法1：通过远程仓库引入依赖

在项目根目录的build.gradle中，先通过buildscript块声明构建脚本所需的依赖，再应用PMD插件：

buildscript {
    repositories {
        mavenCentral() // 可替换为其他包含对应依赖的仓库，如阿里云镜像
    }
    dependencies {
        classpath 'net.sourceforge.pmd:pmd:6.55.0' // 替换为你需要的PMD版本
        classpath 'org.aspectj:aspectjtools:1.9.4'
    }
}

apply plugin: 'pmd'

// 可选：配置PMD规则、检查范围等
pmd {
    ruleSets = ['category/java/bestpractices.xml']
    sourceSets = [sourceSets.main]
}

方法2：使用本地Jar包

如果依赖是本地存储的Jar文件，需确保路径正确，同时在buildscript中引用：

buildscript {
    dependencies {
        classpath fileTree(dir: "${lib}/aspectj-1.9.4", includes: ['*.jar'])
        classpath fileTree(dir: "${lib}/pmd", includes: ['*.jar']) // 需确保本地目录包含完整的PMD Jar包
    }
}

apply plugin: 'pmd'