JGit推送提交时静默失败，为何未抛出覆盖历史的错误？

当远程仓库存在需要覆盖的提交时，Git CLI会直接抛出“不强制推送则无法改写历史”的错误，但JGit执行推送却会静默失败、无错误提示，核心原因在于两者的设计定位和结果处理逻辑不同：

1. JGit的推送结果处理逻辑差异 #

JGit作为Git的Java工具库，执行PushCommand后不会主动抛出异常，而是将每个分支的推送结果封装在PushResult对象中返回。例如遇到非快进推送的情况，对应的RemoteRefUpdate状态会被标记为REJECTED_NONFASTFORWARD，但这个状态不会自动触发异常，需要开发者主动检查结果才能发现失败。

而Git CLI面向终端用户，默认会将这类非快进推送的失败直接以错误输出的形式展示，确保用户能即时感知问题。

2. JGit不主动抛异常的设计考量 #

JGit的设计更偏向灵活性，它允许开发者自行决定如何处理推送失败的场景——比如批量推送多个分支时，即使某个分支推送失败，开发者可能希望继续完成其他分支的推送，这种情况下静默返回结果比强制抛出异常更适合。

3. 如何捕获JGit的非快进推送错误 #

要模拟Git CLI的错误提示行为，需要在执行推送后主动遍历PushResult，检查远程引用的更新状态，手动抛出对应错误：

Git git = Git.open(new File("/path/to/your/repo"));
PushCommand pushCommand = git.push()
        .setRemote("origin")
        .add("main"); // 指定要推送的分支

Iterable<PushResult> pushResults = pushCommand.call();
for (PushResult result : pushResults) {
    for (RemoteRefUpdate update : result.getRemoteUpdates()) {
        RemoteRefUpdate.Status status = update.getStatus();
        if (status == RemoteRefUpdate.Status.REJECTED_NONFASTFORWARD) {
            throw new RuntimeException("因会改写Git历史且未启用强制推送，无法推送到远程");
        }
    }
}

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