Maven插件命令行参数无法覆盖pom.xml配置参数问题

核心结论 #

命令行系统参数（-D开头）的优先级高于pom.xml中的插件配置，你遇到的问题是因为参数绑定的系统属性名称与Maven插件的默认命名规则不匹配，导致命令行参数未被正确映射到插件参数上。

原因解析 #

1. 插件参数的系统属性命名规则
   Maven插件的参数默认对应的系统属性名称格式为[插件前缀].[参数名]（你的插件前缀是javadoc-generator，因此默认属性名应为javadoc-generator.sourcePath）。虽然你在@Parameter注解中指定了property="sourcePath"，但这个全局属性名可能与其他Maven全局属性冲突，或者Maven在加载插件全局配置时，优先使用了pom中的显式配置，而未正确识别全局系统属性。

2. 直接调用插件Goal的配置逻辑
   当你使用mvn javadoc-generator:javadoc直接调用插件Goal时，Maven会加载pom中<plugin>下的全局配置。如果命令行参数的属性名未与插件参数的绑定规则匹配，就会出现pom配置“覆盖”命令行参数的假象。

解决方法 #

方法1：使用插件前缀+参数名的命令行参数

执行命令时，改用插件前缀拼接参数名的系统属性：

mvn javadoc-generator:javadoc -Djavadoc-generator.sourcePath="C:/Projects/my_project/src/main/java/com/core/" -Djavadoc-generator.outputPath="C:/Projects/tmp"

方法2：修改Mojo类的参数绑定注解

调整@Parameter的property属性，明确使用插件前缀绑定的属性名：

@Parameter(property = "javadoc-generator.sourcePath", required = true)
private String sourcePath;

@Parameter(property = "javadoc-generator.outputPath", defaultValue = ".")
private String outputPath;

修改后，命令行即可使用-Djavadoc-generator.sourcePath格式的参数，确保优先级高于pom配置。

补充说明 #

当你执行生命周期阶段（如mvn initialize）时，Maven会加载<executions>中绑定的执行配置，此时正确的命令行参数同样可以覆盖这些配置，优先级规则保持一致。

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