Files
mkdocs/docs/gerrit/gerrit提交代码时遇到钩子问题的解决办法.md
2026-01-13 10:02:35 +08:00

2.3 KiB
Raw Permalink Blame History

你遇到的问题是在向 Gerrit 代码审核平台推送代码时因为提交信息commit message的末尾缺少 Change-Id 标识,导致推送被拒绝了。这是 Gerrit 的强制要求,用于追踪和管理代码评审。

解决方案

我会一步步教你解决这个问题,整个过程分为两步:安装 commit-msg 钩子、补全 Change-Id 并重新推送。

步骤 1安装 Gerrit 的 commit-msg 钩子

这个钩子的作用是在你每次提交代码时,自动在提交信息末尾生成 Change-Id

根据你的报错信息,执行对应的命令(二选一即可):

方式 1使用 SSH推荐

# 获取 git 目录路径并安装钩子
gitdir=$(git rev-parse --git-dir); scp -p -P 29418 renjianbo@101.43.95.130:hooks/commit-msg ${gitdir}/hooks/

# 如果你的 OpenSSH 版本 >= 9.0,需要加 -O 参数
gitdir=$(git rev-parse --git-dir); scp -O -p -P 29418 renjianbo@101.43.95.130:hooks/commit-msg ${gitdir}/hooks/

方式 2使用 HTTP/HTTPS

# 下载钩子文件并赋予执行权限
f="$(git rev-parse --git-dir)/hooks/commit-msg"; curl -o "$f" http://101.43.95.130:8082/tools/hooks/commit-msg ; chmod +x "$f"

步骤 2为已有提交补充 Change-Id 并重新推送

钩子安装完成后,需要为刚才失败的提交补充 Change-Id

# 修正最近一次提交,自动添加 Change-Id--no-edit 表示不修改提交信息内容)
git commit --amend --no-edit

# 重新推送代码到 Gerrit
git push origin HEAD:refs/for/master

验证

执行完上述命令后,如果没有报错,且终端输出类似以下内容,说明推送成功:

Enumerating objects: xxx, done.
Counting objects: 100% (xxx/xxx), done.
...
remote: Processing changes: new: 1, done
To ssh://101.43.95.130:29418/zhini_im
 * [new reference]   HEAD -> refs/for/master

总结

  1. 核心原因Gerrit 要求所有提交必须包含 Change-Id 用于代码评审追踪,你的提交缺少该标识导致推送失败。
  2. 关键操作:先安装 commit-msg 钩子(自动生成 Change-Id再用 git commit --amend --no-edit 补全已有提交的 Change-Id最后重新推送。
  3. 后续预防:安装钩子后,后续所有新提交都会自动生成 Change-Id不会再出现此错误。