本文介绍如何在 Maven 的 pom.xml 中配置插件跳过逻辑，使其能响应命令行传入的 -D 参数（如 -Dmaven.exec.skip=true），从而灵活控制 swagger-codegen-maven-plugin 等插件是否执行。
本文介绍如何在 maven 的 pom.xml 中配置插件跳过逻辑，使其能响应命令行传入的 `-d` 参数（如 `-dmaven.exec.skip=true`），从而灵活控制 swagger-codegen-maven-plugin 等插件是否执行。
在 Maven 项目中，经常需要根据构建环境（如 CI/CD 流水线或本地调试）动态启用或跳过某些插件执行。例如，Swagger 代码生成插件 swagger-codegen-maven-plugin 在非开发阶段往往无需每次运行——但若直接在 <configuration></configuration> 中硬编码 <skip>true</skip>，则完全失去灵活性；而仅靠命令行 -Dxxx 参数又无法自动生效，关键在于建立系统属性与插件配置之间的绑定。
正确做法是：将插件的 <skip></skip> 配置项设为属性占位符，而非固定布尔值。例如：
<plugin>
<groupId>io.swagger.codegen.v3</groupId>
<artifactId>swagger-codegen-maven-plugin</artifactId>
<version>${swagger.codegen.plugin.version}</version>
<executions>
<execution>
<id>generate-folder-pojo</id>
<phase>validate</phase>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<!-- ✅ 正确：绑定到命令行传入的系统属性 -->
<skip>${maven.exec.skip}</skip>
<inputSpec>${swagger.inputSpec}/folder_definition.json</inputSpec>
<language>${swagger.lang}</language>
<templateDirectory>${swagger.api}/template</templateDirectory>
<verbose>false</verbose>
</configuration>
</execution>
</executions>
</plugin>随后，在 Shell 脚本或终端中即可按需控制：
# 跳过该插件执行（等价于 maven.exec.skip=true） mvn validate -Dmaven.exec.skip=true -DskipTests -P copyright,license # 或简写（Maven 会将无值的 -D 属性默认解析为 "true"） mvn validate -Dmaven.exec.skip -DskipTests -P copyright,license # 反之，显式设为 false 可强制启用（即使其他地方有默认 true） mvn validate -Dmaven.exec.skip=false -DskipTests -P copyright,license
⚠️ 注意事项：
- 属性名
maven.exec.skip是自定义的，可任意命名（如skip.swagger.gen），但需确保命令行-D参数与 XML 中${...}占位符严格一致（区分大小写）； - 若未在命令行指定该属性，且
pom.xml中未提供默认值（如<properties><maven.exec.skip>false</maven.exec.skip></properties>），则${maven.exec.skip}展开为空字符串，可能导致插件行为异常（多数插件将空值视为false，但不保证）——建议在<properties></properties>中设置安全默认值； -
skip配置必须位于<execution></execution>的<configuration></configuration>内部，作用于当前 execution；若插件有多个 execution，需分别为其配置<skip></skip>； - 部分插件（如
maven-surefire-plugin）原生支持maven.test.skip等标准属性，但swagger-codegen-maven-plugin不内置此类约定，必须显式绑定。
总结：Maven 插件跳过机制的本质是「属性驱动配置」。通过 ${propertyName} 占位符桥接命令行参数与插件行为，既能保持 pom.xml 的声明式简洁性，又能赋予构建流程高度可配置性——这是编写可维护、可复用 Maven 构建脚本的关键实践。
