使用create-pull-request实现热修复回填的技术实践

在软件开发过程中，热修复（hotfix）是一个常见的场景，特别是在采用dev/prod分支策略的项目中。当我们需要直接将修复代码合并到生产环境（prod分支）时，如何将这些变更同步回开发分支（dev分支）就成为了一个重要问题。

问题背景

在标准的Git工作流中，当开发者在prod分支上直接提交热修复后，需要将这些变更"回填"到dev分支。传统的手动操作方式效率低下且容易出错，因此我们需要借助GitHub Actions自动化这一过程。

技术挑战

通过分析用户提供的案例，我们发现几个关键的技术难点：

1. 在PR关闭事件触发时，Git工作区的状态管理较为复杂
2. 默认的rebase操作可能会掩盖实际需要合并的提交
3. 分支比较逻辑在自动化环境中与本地操作结果不一致
4. 操作失败时的静默处理不利于问题排查

解决方案

基于create-pull-request项目的特性，我们可以采用以下方法实现热修复回填：

1. 明确工作流触发条件：配置工作流在prod分支的PR合并时触发，特别是当PR名称符合热修复模式时（如以"hotfix-"开头）

2. 正确设置分支关系：确保基础分支（base）设置为dev分支，而比较分支设置为包含热修复的临时分支

3. 使用cherry-pick策略：替代默认的rebase操作，通过显式地cherry-pick热修复提交到临时分支，确保变更准确无误

4. 添加失败检测机制：通过检查action的输出结果，在PR创建失败时主动使工作流失败，避免静默错误

实现示例

以下是优化后的工作流配置核心部分：

steps:
  - name: 检出代码库
    uses: actions/checkout@v4
    with:
      ref: prod

  - name: 创建临时分支并cherry-pick热修复
    run: |
      git checkout -b temp-backfill-branch dev
      git cherry-pick <hotfix-commit-hash>

  - name: 创建回填PR
    uses: peter-evans/create-pull-request@v7
    with:
      token: ${{ secrets.SERVICE_ACCOUNT_GITHUB_TOKEN }}
      base: dev
      branch: backfill-${{ github.event.pull_request.head.ref }}

最佳实践建议

1. 分支命名规范：为回填分支建立清晰的命名规则，便于识别和管理

2. 提交验证：在创建PR前添加自动化测试步骤，确保回填不会引入新问题

3. 权限管理：使用专用服务账户的token而非个人token，提高安全性

4. 监控机制：设置工作流运行通知，及时了解回填状态

通过合理配置create-pull-request项目，我们可以实现热修复变更的自动化回填，显著提高开发效率并降低人为错误风险。这一方案特别适合采用严格分支策略的中大型项目。