Jenkins声明式流水线执行自定义Maven目标报未知生命周期阶段错误的排查

问题根因 #

所有触发Unknown lifecycle phase "****"的异常，是三个叠加问题共同导致的，和Maven本身、自定义插件的兼容性无关：

1. Shell脚本参数格式错误，把密文值拆成了独立的Maven参数
   现有脚本里的这行参数：

   -DappId= $APPSCAN_CLOUD_ID \
   

   注意-DappId=和后面的$APPSCAN_CLOUD_ID之间多了一个空格。Shell执行时会把这里拆成两个独立的命令参数：
   • 第一个是无值的JVM属性：-DappId=
   • 第二个是AppID的实际值，作为独立参数传给Maven
     因为AppID是存储在Jenkins的密文凭据里的，Jenkins的安全日志机制会把所有匹配密文的字符串替换为****做掩码，Maven收到这个完全不属于属性定义、也不是合法目标/生命周期的独立参数时，就会抛出“未知生命周期阶段”的错误，错误日志里的占位符****就是被掩码后的密文值。
     本地运行正常，本质是手动执行时没有留这个多余空格，Maven能正确把值和前面的-DappId=绑定为同一个参数，不会触发拆分。
2. 凭据注入的变量匹配不严谨
   流水线环境块里通过credentials("APPSCAN_CLOUD")注入的变量，只有当后台凭据类型设置为「Username with password」时，才会自动生成APPSCAN_CLOUD_USR、APPSCAN_CLOUD_PSW两个拆分变量。如果实际配成了纯Secret text类型，这两个变量会是空值，空值展开后会在命令行留下无意义的空参数，进一步加剧Maven的解析异常。
3. 之前的尝试为什么无效
   你试过把命令改成单行、把自定义插件目标移到参数最前面都没用，是因为参数拆分的逻辑和书写格式无关——只要-Dxxx=和变量值之间存在空格，Shell就会把值拆成独立参数，不管插件目标放在命令的哪个位置，Maven解析参数时都会先读到这个被拆分的密文值，把它当成生命周期阶段处理。
   标准compile、package等目标能正常执行，是因为这些命令不会加载AppScan相关的密文凭据变量，自然不会触发拆分问题。

修复步骤 #

• 调整Shell脚本的参数书写，去掉属性等号和变量之间的所有空格，对可能包含特殊字符的变量加双引号包裹，避免分词：

  #!/bin/bash
  # Run the appscan security check
  mvn -s "$MAVEN_SETTINGS" \
  -DskipTests \
  "-DappId=$APPSCAN_CLOUD_ID" \
  "-DappscanKey=$APPSCAN_CLOUD_USR" \
  "-DappscanSecret=$APPSCAN_CLOUD_PSW" \
  com.hcl.security:appscan-maven-plugin:analyze
  

• 核对Jenkins后台的凭据类型和变量匹配逻辑：
  • 「Username with password」类型的凭据，才会自动拆分出_USR、_PSW后缀的两个变量
  • 「Secret text」类型的凭据，只会注入一个和凭据同名的变量，不会生成额外拆分字段
  • 「File」类型的MAVEN_SETTINGS凭据，注入的$MAVEN_SETTINGS会自动指向临时目录下解密后的settings.xml路径，不需要额外处理路径
• 排查时可以在Maven命令前加一行set -x，Shell会打印实际展开后的完整命令，能直接看到哪个参数被拆成了独立的密文值，快速定位问题。

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