Maven构建中MANIFEST.MF的Release-Name字段来源及修改方法

一、Release-Name字段的可能来源 #

因为你已排查Apache Maven Release插件源码未发现相关逻辑，这个字段大概率来自以下几个方向：

• 子模块pom的War插件配置：父pom未配置不代表子模块的maven-war-plugin没有单独添加Release-Name的manifest条目。
• Jenkins环境或插件注入：Jenkins的Git插件、自定义构建步骤，或是全局Maven配置中，可能通过系统属性、环境变量的方式自动注入了该字段；当前值为main，很大概率和Git分支名直接相关。
• 第三方Maven插件：项目中引入的非官方插件（比如自定义的SCM或构建辅助插件），可能在构建过程中自动往MANIFEST.MF添加该字段。
• 全局Maven配置：服务器上的settings.xml或Maven全局插件配置中，可能定义了默认的manifest条目模板。

二、定位字段来源的实操方法 #

• 检查所有子pom.xml：遍历项目子模块，查找maven-war-plugin的<manifestEntries>配置，确认是否存在Release-Name。
• 分析Jenkins构建日志：在构建日志中搜索“Release-Name”，找到对应字段生成时的插件日志输出，就能定位到具体负责的组件。
• 输出构建环境变量：在Jenkins构建流程中添加步骤，打印所有环境变量，查看是否存在Release-Name或与分支名相关的变量（比如BRANCH_NAME）。
• 检查Maven全局配置：查看Jenkins中Maven安装的全局参数，或是服务器上的~/.m2/settings.xml，确认是否有全局的manifest配置模板。

三、修改Release-Name值的可行方案 #

1. 显式在Maven中配置（最稳妥） #

在父pom或子pom的maven-war-plugin中添加显式配置，覆盖自动生成的值：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.3.2</version> <!-- 使用项目适配的版本 -->
    <configuration>
        <archive>
            <manifestEntries>
                <Release-Name>${custom.release.name}</Release-Name>
                <!-- 保留原有配置条目 -->
                <Version>${project.version}</Version>
                <Revision-Number>${buildNumber}</Revision-Number>
                <Branch>${GIT_BRANCH}</Branch>
                <Local-Branch>${scmBranch}</Local-Branch>
            </manifestEntries>
        </archive>
    </configuration>
</plugin>

其中${custom.release.name}可替换为你需要的值，比如Git分支名${GIT_BRANCH}、项目版本${project.version}，或是自定义的Jenkins参数。

2. 通过Jenkins构建参数传递 #

在Jenkinsfile中定义自定义参数，通过Maven系统属性传递给构建命令：

pipeline {
    agent any
    parameters {
        string(name: 'RELEASE_NAME', defaultValue: 'main', description: '自定义Release-Name值')
    }
    stages {
        stage('Build') {
            steps {
                sh 'mvn release:clean release:prepare -P<profiles> -U -DautoVersionSubmodules="true" -Darguments="-T 1C -DskipTests=true -DRelease-Name=${params.RELEASE_NAME}" -V --batch-mode --errors'
            }
        }
    }
}

3. 禁用自动注入的插件/配置 #

如果排查到是第三方插件或全局配置自动生成该字段，可在pom中添加插件配置，关闭该字段的自动生成逻辑，或是调整全局配置模板。

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