如何在pom.xml中引用Bamboo元数据标签下定义的自定义构建变量

问题现状 #

• 已验证可用的参考链路：同板块的内置变量buildNumber，通过Bamboo Maven任务传参-DbuildNumber=${bamboo.buildNumber}，在pom.xml中以${buildNumber}引用可正常拼接输出文件名
• 自定义Metadata变量appname的三次尝试均失败：
  1. Bamboo执行配置添加-Dappname=${bamboo.appname)，pom以${appname}引用不生效
  2. 同上传参配置不变，pom以${bamboo.appname}引用取值为null
  3. 同上传参配置不变，pom以${bamboo_appname}引用不生效

根因定位 #

• 第一类无效配置的核心问题：Bamboo变量占位符语法错误，写在传参里的占位符使用了右圆括号)闭合，而非合法的右花括号}，Bamboo无法识别该占位符，不会做实际值替换，导致Maven进程拿到的是字面字符串而非真实变量值
• 第二类、第三类无效配置的核心问题：

1. Maven的属性解析逻辑是，命令行通过-D传入的参数优先级最高，直接以参数名作为属性key即可读取；用户仅通过-Dappname传参，并未传递名为bamboo.appname的属性，因此在pom中以${bamboo.appname}引用时自然取不到值返回null
2. Bamboo仅会自动将内置变量按“点换下划线、全大写”的规则注入为系统属性，自定义Metadata变量不会自动以bamboo_appname的格式注入环境或系统属性，因此在pom中直接引用${bamboo_appname}也无法取到值

正确配置步骤 #

1. 修正Bamboo端的传参写法
   • 在Bamboo的Maven任务配置页，找到“额外命令行参数”配置栏，写入正确格式的传参：
     -Dappname=${bamboo.appname}
   • 配置时逐字符核对：
     • 占位符必须用${}格式，不要混用圆括号
     • 变量名和Metadata标签页定义的appname拼写、大小写完全一致，无多余空格或不可见字符
2. 修正pom.xml端的引用写法
   • 和已生效的buildNumber引用逻辑保持一致，直接以${appname}形式引用即可，不需要额外加bamboo.或bamboo_前缀
   • 引用示例：
     ${project.artifactId}-${project.version}.${appname}
3. 有效性校验
   • 在Maven任务前新增一个Shell/PowerShell脚本步骤，执行echo "当前appname值: ${bamboo.appname}"，先确认Bamboo端能正常替换变量值，再执行Maven构建
   • 检查pom.xml中是否存在和appname重名的内部properties属性，如果有需要删除，避免内部属性覆盖命令行传入的参数值

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