集成PMD到项目触发java.lang.IllegalArgumentException报错，求协助

嘿，这个java.lang.IllegalArgumentException: No rules found的错误我之前帮不少开发者解决过，大概率是规则集配置或路径相关的问题，咱们一步步来排查：

1. 检查自定义规则集文件的有效性 #

• 确认规则集的XML格式正确：根节点必须是<ruleset>，且包含正确的命名空间（比如xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"），格式错误会导致PMD无法解析规则。
• 核对规则名的拼写：比如把UnusedLocalVariable误写成UnusedLocVar，或者引用了当前PMD版本不存在的规则（不同版本规则可能有更名/移除），都会触发这个错误。
• 确保规则集包含有效规则：如果规则集里所有规则都被注释掉，或者没有任何<rule>节点，PMD自然找不到可执行的规则。

2. 验证pom.xml中PMD插件的配置 #

• 检查规则集文件路径是否正确：
  • 如果规则集放在src/main/resources/pmd-rules.xml，插件配置里的<ruleset>应该写src/main/resources/pmd-rules.xml；如果是类路径引用，要写成classpath:pmd-rules.xml。路径错误会导致PMD找不到规则集文件。
• 确认PMD版本与规则兼容：比如你用了PMD 7.x，但规则集里还引用了6.x的旧规则（比如java-basic里的部分规则在7.x中被迁移），也会出现找不到规则的情况。
• 排查是否有意外的规则排除配置：比如插件里不小心加了<excludeAllRules>true</excludeAllRules>，或者所有规则都被<exclude>标签排除了，这会导致没有可执行的规则。

3. 用命令行快速验证规则集 #

可以直接使用PMD命令行工具测试规则集，避免项目配置的干扰：

pmd check -d src/main/java -R path/to/your/custom-ruleset.xml

• 如果命令行运行正常，说明规则集本身没问题，问题出在pom.xml的插件配置上；
• 如果命令行也报同样的错误，那就是规则集文件本身存在问题，需要重新检查规则集的内容和格式。

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