Maven release:prepare/perform是否需创建分支？执行时为何分支不存在报错？

错误原因定位 #

你遇到的fatal: Remote branch notification-service-0.0.3 not found错误，核心是Maven Release Plugin的行为与你的配置/预期不匹配：

• 默认情况下，release:prepare不会创建以版本号命名的分支，它只会在当前分支（你使用的通用release分支）完成两次提交：将版本从快照版（如0.0.3-SNAPSHOT）改为正式版0.0.3，再改为下一个快照版（如0.0.4-SNAPSHOT），最后基于正式版提交创建Git标签notification-service-0.0.3。
• release:perform默认是拉取这个标签来执行构建，而非分支。报错说明你的插件配置中可能指定了<branchName>参数，强制插件尝试切换到以版本号命名的分支，或者CI环境未拉取全量Git标签/分支导致本地找不到对应引用。

关于版本分支的疑问解答 #

1. Maven Release流程是否需要为每个版本创建新分支？ #

不需要——默认行为下完全不需要。只有当你需要在独立分支上做发布前的最后修复（比如Git Flow模型）时，才需要创建临时release分支。

2. 通用release分支的问题 #

你当前使用的“通用长期存在的release分支”不符合标准Git Flow模型：

• 标准Git Flow中，release分支是临时分支：为某个具体版本（如release/0.0.3）从develop分支切出，用于发布前的bug修复，完成后合并到main和develop分支，随后删除该临时分支。
• 长期共用一个release分支会导致分支职责模糊，容易混入未完成的开发代码，增加发布风险。

修复步骤 #

1. 检查Maven Release Plugin配置
   打开项目的pom.xml，查看是否有如下配置：

   <plugin>
     <groupId>org.apache.maven.plugins</groupId>
     <artifactId>maven-release-plugin</artifactId>
     <version>your-version</version>
     <configuration>
       <!-- 如果存在这个配置，要么删除，要么改为你的通用release分支名 -->
       <branchName>${project.version}</branchName>
     </configuration>
   </plugin>
   

   若存在<branchName>${project.version}</branchName>，删除该配置即可让插件回到默认的基于标签构建的逻辑；若需要指定分支，改为你的通用release分支名（如<branchName>release</branchName>）。

2. 确保CI环境拉取全量Git资源
   在流水线执行mvn release:perform前，添加Git命令拉取所有标签和分支：

   git fetch --tags --prune --prune-tags
   

   避免本地仓库因缺少标签或分支引用导致报错。

3. 验证仓库权限
   确认CI使用的Bitbucket账号拥有推送分支、标签的权限，确保release:prepare创建的标签已成功推送到远程仓库。

分支策略建议 #

• 若坚持使用Git Flow：放弃通用release分支，改为为每个版本创建临时release/x.x.x分支，发布完成后合并到main和develop并删除。
• 若希望简化流程：采用GitHub Flow这类轻量化策略，直接在main分支上开发快照版本，发布时用Maven Release Plugin在main分支打标签，无需单独的release分支。

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