Jenkins 2.401.1更新后作业名称未设置引发宏错误求助

问题现象 #

• 升级到Jenkins 2.401.1后，流水线作业历史记录仅显示数字ID，无法正常展示自定义作业名称
• 作业运行时抛出错误：

Failed to evaluate name
macro:org.jenkinsci.plugins.tokenmacro.MacroEvaluationException: Error processing tokens

解决思路 #

1. 排查Token Macro插件兼容性

   • 错误直接关联tokenmacro插件，先确认该插件版本与Jenkins 2.401.1是否适配。可尝试回退至升级前的插件稳定版本，或更新到最新兼容版本。

2. 检查流水线名称定义逻辑

   • 查看流水线代码中设置作业名称的宏定义（比如BUILD_NAME或自定义变量），确认是否存在语法错误或使用了已废弃的宏格式。例如排查类似代码：

     currentBuild.displayName = "#${BUILD_NUMBER} - ${CUSTOM_PROJECT_NAME}"
     

   • 确保变量在执行阶段已正确初始化，替换为Jenkins 2.401.1支持的变量格式。

3. 回退Jenkins版本验证

   • 若插件调整无效，可临时回退到之前稳定的Jenkins版本（如2.400.x系列），确认是否为版本兼容性问题。待官方修复或插件适配完成后再重新升级。

4. 查看系统日志定位细节

   • 进入「Manage Jenkins → System Log」，找到MacroEvaluationException的完整堆栈信息，定位具体失败的宏，针对性修复问题。

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