如何让Maven忽略未识别命令行选项并继续执行？

问题描述 #

我在重构CI流水线脚本时遇到了如下问题：
执行命令：

$ mvn $MAVEN_CLI_OPTS clean compile

得到错误输出：

Unable to parse command line options: Unrecognized option: --no-transfer-progress

原因是我在默认配置中添加了--no-transfer-progress参数，但运行环境使用的是旧版本Maven，不支持该参数。虽然我可以通过SDKMAN!获取新版本Maven作为临时方案，但希望CI脚本尽可能通用——对于没有.sdkmanrc文件、依赖runner上默认Maven版本（我无控制权）的项目流水线，不会执行失败。

解决方案 #

Maven本身没有提供「忽略未识别命令行选项」的机制，不过可以通过以下两种通用方案解决你的问题：

• 方案一：尝试带参数执行，失败则 fallback 到无参数命令
  这是最简洁的通用方案，不需要检测版本，直接先尝试带参数的命令，如果因为参数不识别报错，就自动执行不带该参数的版本：

  # 先尝试带--no-transfer-progress参数执行，失败则执行无参数版本
  mvn $MAVEN_CLI_OPTS --no-transfer-progress clean compile || mvn $MAVEN_CLI_OPTS clean compile
  

  这个逻辑在CI环境中非常实用，不管runner上的Maven版本是新是旧，都能保证命令执行成功。

• 方案二：检测Maven版本，按需添加参数
  如果希望避免执行两次命令的开销，可以先检测Maven版本，只在版本支持时添加--no-transfer-progress参数（该参数从Maven 3.6.1开始支持）：

  # 提取Maven的完整版本号（如3.6.0、3.8.6）
  MAVEN_SHORT_VERSION=$(mvn -v | grep -Eo 'Apache Maven [0-9]+\.[0-9]+\.[0-9]+' | grep -Eo '[0-9]+\.[0-9]+\.[0-9]+')
  # 用自然排序对比版本，仅在3.6.1及以上版本添加参数
  if [[ "$(printf '%s\n' "3.6.1" "$MAVEN_SHORT_VERSION" | sort -V | head -n1)" == "3.6.1" ]]; then
      MAVEN_CLI_OPTS="$MAVEN_CLI_OPTS --no-transfer-progress"
  fi
  # 执行构建命令
  mvn $MAVEN_CLI_OPTS clean compile
  

  这里用sort -V做版本的自然排序对比，比纯字符串对比更准确，能正确处理诸如3.10.0这类版本号的对比。

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