如何移除Bitbucket只读钩子？解决推送报错及API调用401问题

Jira与Bitbucket已关联，在两者中做了一些更改后，推送代码时出现如下错误：

! [remote rejected] test_pre_hook -> test_pre_hook (pre-receive hook declined)

经排查确认是Smart Commit配置出错，在Bitbucket仓库中发现了只读钩子。根据官方文档，这类钩子无法通过常规自定义钩子的方式移除，且尝试打开“查看请求”时，页面提示“无法加载Webhook详情，请刷新页面或返回Webhook列表”。

需解决以下问题：

1. 该问题的产生原因及需排查的位置（以撤销/移除相关更改）；
2. 如何配置这些钩子以无需移除；
3. 如何通过curl移除钩子（当前调用指定curl命令无输出，退出码为0，verbose模式显示HTTP/2 401）

1. 问题原因与排查位置 #

• 原因：Bitbucket与Jira关联后自动生成的Smart Commit只读钩子配置异常，比如Jira项目关联错误、Smart Commit语法规则冲突，或是钩子调用Jira API时权限/参数出错，导致pre-receive钩子触发后拒绝代码推送。近期修改过Jira-Bitbucket关联设置、Smart Commit全局/仓库级规则，也可能引发该问题。
• 排查位置：
  • 检查Bitbucket仓库的Smart Commit配置：进入仓库设置，找到Jira集成选项，核对关联的Jira项目、允许的Smart Commit操作（如提交消息语法规则）是否正确。
  • 查看Jira侧的应用链接配置：确认Bitbucket的应用链接是否具备读写Jira问题的权限，关联时是否选错了项目范围。
  • 查阅操作日志：Bitbucket仓库操作日志、Jira应用链接日志，定位近期修改钩子配置或关联设置的记录，针对性撤销更改。
  • 测试提交消息：用符合标准Smart Commit语法的内容推送测试（如TEST-123 #comment 测试提交），判断是否因消息语法触发钩子拒绝。

2. 钩子正确配置（无需移除） #

只读钩子是Bitbucket与Jira集成的默认组件，无需移除，修正配置即可正常使用：

• 核对关联关系：确保Bitbucket仓库关联的是正确的Jira项目，避免误关联不存在或权限不足的项目。
• 配置Smart Commit规则：在Bitbucket仓库的Jira集成设置中，明确允许的操作（如#comment、#resolve、#close等），要求团队提交消息遵循[Jira问题键] [操作指令] [描述]格式，例如PROJ-456 #resolve 修复登录跳转bug。
• 配置权限：在Jira应用链接中，给Bitbucket授予Jira Software权限，确保钩子能正常调用Jira API验证提交消息并操作问题。
• 测试有效性：推送一条符合语法的代码提交，观察钩子是否正常通过，同时在Jira中查看对应问题是否被正确更新，验证配置生效。

3. 通过curl移除钩子（解决401问题） #

HTTP/2 401是权限不足导致，需正确配置认证信息：

• 获取认证凭证：生成Bitbucket个人访问令牌（PAT），勾选repository:admin权限（修改钩子需仓库管理员权限）。
• 先获取钩子ID：调用接口列出仓库所有钩子，找到Smart Commit相关的只读钩子ID：

  curl -u "你的用户名:个人访问令牌" "https://bitbucket.org/api/2.0/repositories/你的工作区/仓库名/hooks"
  

  在响应中找到描述含"Smart Commit"或"Jira integration"的钩子，复制其uuid作为钩子ID。
• 执行删除命令：

  curl -X DELETE -u "你的用户名:个人访问令牌" "https://bitbucket.org/api/2.0/repositories/你的工作区/仓库名/hooks/钩子ID"
  

• 注意：若使用Bitbucket Server/Data Center，API路径需调整为http://你的服务器地址/rest/api/1.0/projects/项目键/repos/仓库名/hooks/钩子ID，认证可使用用户名密码或令牌。

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