maven-pmd-plugin不生成警告仅输出空报告配置问题排查

你的配置存在4个核心错误，是PMD始终生成空报告、无违规警告的直接原因：

• 插件绑定的生命周期阶段错误
• 多模块场景下插件继承/聚合逻辑未生效
• 全局统一输出目录导致报告被覆盖
• 非标准源码路径未被纳入扫描范围，且未显式指定检查规则集

具体错误说明 #

1. 生命周期绑定错误
   你把pmd目标绑定到了validate阶段，这个阶段是Maven构建最早的生命周期节点，此时Maven还未完成子模块上下文、源码路径的解析，插件执行时拿到的待扫描文件列表为空，自然只会生成空报告。

2. 多模块插件未正确生效
   你在根POM的<build><plugins>下直接配置插件，但如果根POM仅作为聚合POM（子模块未通过<parent>标签继承根POM配置），子模块不会自动执行这个插件配置，最终只有根目录本身（无业务源码）执行了PMD检查，输出空报告。

3. 输出目录配置冲突
   你将所有模块的PMD报告输出路径统一设置为${project.basedir}/../../../../out/，多模块构建时，后执行的模块会直接覆盖前序模块生成的报告，最后留存的很可能是无源码模块生成的空报告。

4. 扫描路径与规则缺失
   你的子模块路径为src/dummy1/jni、src/dummy2/jni，属于非标准Maven源码目录（PMD默认扫描路径为src/main/java、src/test/java），如果没有显式将这些目录标记为源码目录，PMD不会扫描其中的代码。同时你未显式配置PMD规则集，部分场景下会出现默认规则加载失败、无检查规则可用的问题。

修复方案 #

按如下步骤调整配置：

1. 将PMD插件的执行阶段从validate改为verify，该阶段在编译、资源处理完成后执行，适合做代码质量检查。
2. 确认子模块继承关系：如果子模块未声明根POM为parent，将PMD插件配置移到<build><pluginManagement>节点下，在需要执行检查的子模块中单独声明插件（无需重复写版本和配置）即可继承根配置。
3. 修改输出目录，为每个模块单独分配报告输出路径，避免文件覆盖。
4. 显式指定PMD规则集；如果使用非标准源码目录，要么通过build-helper-maven-plugin将目录加入源码路径，要么在PMD配置中显式声明扫描目录。

修正后的插件配置参考 #

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-pmd-plugin</artifactId>
  <version>3.17.0</version>
  <configuration>
    <linkXRef>true</linkXRef>
    <targetJdk>1.8</targetJdk>
    <skipEmptyReport>false</skipEmptyReport>
    <!-- 按模块拆分输出目录，避免文件覆盖 -->
    <outputDirectory>${project.basedir}/../../../../out/${project.artifactId}/pmd/</outputDirectory>
    <xrefLocation>${project.basedir}/../../../../out/${project.artifactId}/xref/</xrefLocation>
    <!-- 显式指定规则集，包含未使用代码检查规则，覆盖你添加的测试场景 -->
    <rulesets>
      <ruleset>rulesets/java/basic.xml</ruleset>
      <ruleset>rulesets/java/unusedcode.xml</ruleset>
    </rulesets>
    <!-- 非标准源码目录可显式指定扫描路径，按需开启 -->
    <!--
    <sourceDirectories>
      <sourceDirectory>${project.basedir}/jni</sourceDirectory>
    </sourceDirectories>
    -->
    <!-- 检测到违规时直接打印错误、中断构建，避免漏看警告 -->
    <failOnViolation>true</failOnViolation>
    <printFailingErrors>true</printFailingErrors>
  </configuration>
  <executions>
    <execution>
      <goals>
        <goal>pmd</goal>
      </goals>
      <!-- 修正执行阶段为verify -->
      <phase>verify</phase>
    </execution>
  </executions>
</plugin>

验证方式 #

配置调整完成后，在项目根目录执行mvn clean verify，控制台会直接输出PMD检测到的违规信息，对应报告也会按模块生成到配置的out目录下。

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