MisakaNet/lessons/contrib/dco-signoff-force-push-pitfall.md at test-sync-answered-questions · ghzhost/MisakaNet

title

DCO Signoff Lost During Force Push

domain

devops

Problem

Force push 后 DCO (Developer Certificate of Origin) check 持续失败，即使本地 commit 有 Signed-off-by。

Root Cause

git commit --amend --signoff 只修改当前 commit，但 PR 可能包含多个 commit
git reset --soft main 后 re-commit 会丢失之前的 signoff
git cherry-pick 不保留 signoff，需要显式 --signoff
GitHub PR 的 DCO check 检查所有 commit，不只是最新一个

Solution

# 正确做法：reset --hard 到干净 base，然后 cherry-pick --signoff
git fetch upstream main
git reset --hard upstream/main
git cherry-pick <your-commit> --signoff
git push fork branch --force

# 验证：PR 应该只有 1 个 commit
gh api repos/UPSTREAM/REPO/pulls/NUMBER/commits --jq 'length'

通用预防（合并自 intake #1099 同主题 lesson）：

# 方法1：rebase 时自动 signoff
git rebase --signoff HEAD~N

# 方法2：amend 当前 commit 补 signoff
git commit --amend --signoff --no-edit

# 方法3：检查所有 commit 是否有 signoff
git log --format="%H %s" | while read hash msg; do
  if ! git log -1 --format="%B" $hash | grep -q "Signed-off-by:"; then
    echo "Missing signoff: $hash $msg"
  fi
done

预防措施：

在 .gitconfig 中设置 git config format.signoff true
使用 git commit -s 而不是 git commit
CI 中添加 DCO 检查 pre-commit hook

Key Points

git reset --soft main 不够——soft reset 会保留旧 commit 的 parent 关系
必须用 git reset --hard upstream/main 彻底切断
Cherry-pick 后用 git log --oneline main..branch 确认只有 1 个 commit
DCO check 失败时，先查 gh api pulls/NUMBER/commits 确认 commit 数量
DCO 检查检查所有 commit，不只是最新的；force push 可能丢失 signoff

Why: DCO 是开源项目的硬性要求，signoff 丢失会导致 PR 无法合并 How to apply: Force push 后必须验证 PR commit 数量和 signoff 状态

Verification

# 检查最新 commit 的 signoff
git log --format="%b" -1 | grep -i "Signed-off-by" || echo none

# 检查 PR 所有 commit 的 signoff（DCO 检查的是全部 commit）
gh api repos/UPSTREAM/REPO/pulls/NUMBER/commits --jq 'length'

Expected Output:

Signed-off-by:

FilesExpand file tree

dco-signoff-force-push-pitfall.md

Latest commit

History