求助：Bitbucket Server 8/Git 2.39中自定义Git合并驱动不再执行

以下是针对该问题的具体排查方向和解决方案：

• 检查Bitbucket运行用户的Git配置加载情况
  Bitbucket Server 8.x 调整了Git执行的上下文环境，可能导致原全局.gitconfig未被正确加载。确认Bitbucket服务运行用户（通常是atlbitbucket）的家目录下存在该配置文件，且配置内容正确。如果全局配置无法生效，可将合并驱动配置迁移到仓库级的.git/config文件中，确保仓库能直接读取到驱动定义。

• 验证合并驱动脚本的权限与路径有效性
  升级后环境可能变更了文件权限或路径：

  • 确认/path/to/mergedriver.sh存在且Bitbucket运行用户有执行权限（执行chmod +x /path/to/mergedriver.sh赋予权限）
  • 避免使用指向个人目录的绝对路径，改用Bitbucket数据目录下的稳定路径存放脚本

• 确认合并场景触发了冲突检测
  Git仅在文件存在内容冲突时才会调用自定义合并驱动，快速合并（fast-forward）或无冲突合并不会触发驱动执行。测试时需构造真正的文件内容冲突场景，验证驱动是否被调用。

• 排查Git版本变更的参数兼容性
  Git 2.23到2.39之间，合并驱动的参数传递逻辑无重大变更，但可通过在脚本中添加日志确认驱动是否被调用：
  在mergedriver.sh开头添加日志记录代码：

  echo "[$(date)] Merge driver invoked with args: $@" >> /var/log/bitbucket-mergedriver.log
  

触发合并后查看日志，若日志无记录，说明驱动未被Git调用；若有记录，可进一步分析参数是否符合脚本预期。

• 验证Bitbucket合并流程的调用逻辑
  先在本地克隆仓库，手动执行合并操作：

  git checkout your-feature-branch
  git merge target-branch
  

如果本地合并时驱动正常执行，说明问题出在Bitbucket Server的环境或配置上；若本地也失效，需检查Git配置语法或脚本逻辑是否适配新版本Git。

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