问题复现与现象 #

• 操作步骤：在Gerrit网页中选择某一分支或标签执行删除操作
• 预期结果：Gerrit网页端成功删除分支/标签的同时，GitLab后端同步完成删除
• 实际问题：GitLab对应的分支/标签未被删除；但常规代码变更可正常同步到GitLab，replication_log日志无报错，删除标签时也存在相同问题

可能的原因及排查解决步骤 #

1. 检查Gerrit复制配置是否监听删除事件 #

Gerrit的复制功能需要明确配置才会推送分支/标签的删除操作。打开Gerrit的复制配置文件（通常路径为$GERRIT_SITE/etc/replication.config），确认目标GitLab的远程配置段是否包含删除事件的推送规则：

[remote "gitlab"]
    url = git@gitlab.example.com:your-project.git
    push = +refs/heads/*:refs/heads/*
    push = +refs/tags/*:refs/tags/*
    # 关键配置：开启删除事件推送
    push = +refs/heads/*:refs/heads/* --delete
    push = +refs/tags/*:refs/tags/* --delete

如果缺少--delete参数，Gerrit不会将删除操作同步到GitLab。补充配置后重启Gerrit服务即可生效。

2. 手动触发复制任务验证逻辑 #

有时候自动复制任务可能未正确触发删除事件推送，可以手动执行一次全量复制来测试：

• 通过SSH连接Gerrit服务器：ssh -p 29418 your-gerrit-account@gerrit.example.com
• 执行手动复制命令：gerrit replication start --all
  完成后检查GitLab是否同步了删除操作，同时查看replication_log是否出现对应推送记录。

3. 确认GitLab仓库的权限配置 #

确保Gerrit用于复制的SSH账号拥有GitLab仓库的分支/标签删除权限：

• 进入GitLab项目的「设置」→「成员」页面
• 检查Gerrit账号的权限等级：至少需要「开发者」权限（可删除自己创建的分支），若要删除所有分支则需要「维护者」及以上权限

4. 核对分支/标签命名的一致性 #

部分场景下会因为分支/标签命名大小写、特殊字符不一致（比如Gerrit是feature/Test，GitLab是feature/test），导致删除操作无法匹配到目标引用。仔细核对两者的分支/标签名称，确保完全一致。

5. 检查Gerrit的error_log日志 #

虽然replication_log无报错，但底层的连接、权限问题可能会记录在error_log中。查看$GERRIT_SITE/logs/error_log，搜索与GitLab复制相关的条目，排查是否存在隐藏的错误信息。

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