求助：仅Jenkins中Maven Release插件出现变更记录格式错误

问题描述 #

使用maven-release-plugin 3.0.0（含其他多个版本），本地执行发布流程正常，但在Jenkins中执行时抛出错误：Only [] formats are supported for change recordings。插件配置如下：

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-release-plugin</artifactId>
        <version>3.0.0</version>
        <configuration>
            <preparationGoals>clean install</preparationGoals>
        </configuration>
    </plugin>
</plugins>

可能原因及解决办法 #

1. 显式设置空变更记录格式 #

该错误是因为maven-release-plugin在Jenkins环境中无法识别当前SCM的变更记录格式，可在插件配置中强制指定空格式：

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-release-plugin</artifactId>
        <version>3.0.0</version>
        <configuration>
            <preparationGoals>clean install</preparationGoals>
            <!-- 强制设置空的变更记录格式 -->
            <changeLogFormat></changeLogFormat>
        </configuration>
    </plugin>
</plugins>

2. 检查Jenkins任务的SCM配置 #

• 进入Jenkins任务配置页面，打开源码管理模块（以Git为例）
• 点击「高级」按钮，检查「Change log format」字段，确保其为空（不要设置自定义格式）
• 保存配置后重新执行发布任务

3. 补充POM中的SCM配置 #

若项目POM未配置SCM信息，插件在Jenkins环境下可能无法正确识别仓库，需补充完整配置：

<scm>
    <connection>scm:git:https://your-git-repo-url.git</connection>
    <developerConnection>scm:git:https://your-git-repo-url.git</developerConnection>
    <url>https://your-git-repo-url.git</url>
</scm>

根据实际仓库协议调整地址，如SSH协议改为scm:git:git@your-git-repo-url.git

4. 检查Jenkins节点的Git用户配置 #

确保Jenkins执行任务的节点已配置Git用户信息，插件打tag提交时需要这些信息：

git config --global user.name "your-username"
git config --global user.email "your-email@example.com"

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