如何借助Jenkins及Pipeline Multibranch Plugin实现跨分支唯一构建编号

我太懂这个痛点了——用Multibranch Pipeline搭配Blue Ocean时，每个分支的构建编号都从0从头开始计数，跨分支的编号重复得一塌糊涂，完全没法实现从已部署应用到CI记录、再到源码变更的全链路追溯，这对需要严格追踪问题的项目来说简直是噩梦。

下面给你几个经过实际项目验证的解决方案，按需选就行：

1. 全局共享递增构建编号（最推荐） #

借助Jenkins的全局属性维护一个统一的递增编号，让所有分支共用这个序列，彻底解决唯一性问题：

• 先确保安装了Groovy Postbuild插件（没装的话去插件市场搜一下）
• 进入Jenkins「系统管理」→「系统设置」，添加一个全局环境变量，比如globalBuildNumber，初始值设为1
• 在你的Jenkinsfile里加入这段Groovy脚本，获取并更新全局编号：

// 读取全局构建编号
def globalBuildNum = Jenkins.instance.getGlobalNodeProperties()[0].getEnvVars()['globalBuildNumber'] as Integer
// 把当前构建的显示名改成全局编号
currentBuild.displayName = "#${globalBuildNum}"
// 全局编号自增并保存
Jenkins.instance.getGlobalNodeProperties()[0].getEnvVars()['globalBuildNumber'] = (globalBuildNum + 1).toString()
Jenkins.instance.save()

这样不管哪个分支触发构建，编号都是全局唯一且连续递增的，完美适配追溯需求。

2. 分支前缀+分支内编号（轻量方案） #

如果不想折腾全局变量，最简单的方式是给每个分支的构建编号加上分支名前缀，比如feature/pay-#5、main-#22，这样即使分支内编号重复，加上前缀后全局就唯一了。在Jenkinsfile里一行代码就能实现：

currentBuild.displayName = "${env.BRANCH_NAME}-#${currentBuild.number}"

这种方式零额外插件依赖，缺点是编号不是全局连续递增，但满足唯一性和基础追溯需求完全没问题。

3. 外部存储维护全局编号（分布式场景） #

如果你的Jenkins是分布式集群，或者担心全局变量的并发冲突，可以用外部存储（比如Redis、MySQL）来维护全局编号。比如用Redis的话，流水线里调用incr命令就能拿到唯一编号：

def globalBuildNum = sh(script: 'redis-cli INCR jenkins_global_build_seq', returnStdout: true).trim()
currentBuild.displayName = "#${globalBuildNum}"

这种方式能保证高并发场景下的编号唯一性，适合复杂的Jenkins部署环境。

另外要提一句，修改displayName后，Blue Ocean的构建列表里也会显示自定义的编号，完全不影响可视化体验。

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