Files
mkdocs/docs/gerrit/gerrit提交代码时遇到钩子问题的解决办法.md

50 lines
2.3 KiB
Markdown
Raw Permalink Normal View History

2026-01-13 10:02:35 +08:00
你遇到的问题是在向 Gerrit 代码审核平台推送代码时因为提交信息commit message的末尾缺少 `Change-Id` 标识,导致推送被拒绝了。这是 Gerrit 的强制要求,用于追踪和管理代码评审。
### 解决方案
我会一步步教你解决这个问题,整个过程分为两步:安装 commit-msg 钩子、补全 Change-Id 并重新推送。
#### 步骤 1安装 Gerrit 的 commit-msg 钩子
这个钩子的作用是在你每次提交代码时,自动在提交信息末尾生成 `Change-Id`
根据你的报错信息,执行对应的命令(二选一即可):
**方式 1使用 SSH推荐**
```bash
# 获取 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**
```bash
# 下载钩子文件并赋予执行权限
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`
```bash
# 修正最近一次提交,自动添加 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不会再出现此错误。