Bitbucket PostRepositoryHook合并Pull Request时未触发问题

嗨，我之前开发Bitbucket插件时也踩过这个一模一样的坑！你遇到的问题本质是Bitbucket里PR合并的操作类型和普通git push完全不同，导致PostRepositoryHook没被触发。下面给你拆解原因和可行的解决方案：

为什么PR合并不触发PostRepositoryHook？ #

普通的git push是用户直接向仓库推送提交，属于外部用户发起的仓库操作，会触发PostRepositoryHook；但PR合并是Bitbucket通过内部API执行的仓库写入操作，默认属于内部系统操作，而PostRepositoryHook默认只监听外部用户主动发起的push事件，所以不会被触发。

解决方案1：改用PR合并专用钩子（推荐） #

Bitbucket提供了专门监听PR合并事件的钩子接口，比通用的仓库钩子更精准，推荐用PullRequestPostMergeHook，它会在PR合并完成后可靠触发。

示例代码：

import com.atlassian.bitbucket.hook.pull.PullRequestPostMergeHook;
import com.atlassian.bitbucket.hook.pull.PullRequestPostMergeContext;
import com.atlassian.bitbucket.util.Logger;
import com.atlassian.bitbucket.util.LoggerFactory;

public class LoggingPullRequestMergeHook implements PullRequestPostMergeHook {

    private static final Logger log = LoggerFactory.getLogger(LoggingPullRequestMergeHook.class);

    @Override
    public void onCompleted(PullRequestPostMergeContext context) {
        // 在这里处理PR合并后的逻辑，比如记录操作日志
        log.info("PR #{} 已合并到分支 {}，合并提交ID：{}",
                context.getPullRequest().getId(),
                context.getPullRequest().getToRef().getDisplayId(),
                context.getMergeCommit().getId());
    }
}

然后在插件的Spring配置里注册这个钩子：

<bean id="loggingPullRequestMergeHook" class="com.yourcompany.plugin.hook.LoggingPullRequestMergeHook"/>
<bean class="com.atlassian.bitbucket.hook.pull.PullRequestHookRegistration">
    <constructor-arg ref="loggingPullRequestMergeHook"/>
</bean>

解决方案2：让PostRepositoryHook监听内部操作（不推荐） #

如果你一定要沿用PostRepositoryHook，可以修改钩子的注册配置，让它监听所有类型的仓库操作（包括内部系统发起的PR合并）。

在钩子的配置类里，使用HookRegistration.Builder指定Trigger.ALL：

import com.atlassian.bitbucket.hook.repository.HookRegistration;
import com.atlassian.bitbucket.hook.repository.PostRepositoryHook;
import com.atlassian.bitbucket.hook.repository.Trigger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class HookConfig {

    @Bean
    public PostRepositoryHook loggingPostRepositoryHook() {
        return new LoggingPostRepositoryHook();
    }

    @Bean
    public HookRegistration loggingHookRegistration() {
        return HookRegistration.builder()
                .hook(loggingPostRepositoryHook())
                .trigger(Trigger.ALL) // 关键：监听所有操作，包括内部PR合并
                .build();
    }
}

注意事项 #

• 不同Bitbucket版本的钩子API可能略有差异，比如旧版本可能用PullRequestMergeHook而不是PullRequestPostMergeHook，请对应你使用的Bitbucket版本调整。
• 测试时确保PR是通过Bitbucket界面点击"Merge"按钮完成的，而不是本地merge后再push（后者属于普通push，本来就会触发PostRepositoryHook）。

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