如何通过脚本或API触发Jenkins的Save/Apply事件以激活Bitbucket Webhook？

算力阿峰

2026-10-3

解决方案

该问题的核心原因是直接通过XML导入创建任务时，Bitbucket Server插件的Webhook自动注册逻辑不会被触发，只有触发任务配置的保存流程时才会执行插件对应的后置处理逻辑，完成Webhook的激活。

方案一：复用python-jenkins原生接口（轻量实现）

创建完任务后直接执行二次配置覆盖即可，无需额外调用其他接口：

调用get_job_config()方法获取刚创建的任务的XML配置内容
调用reconfig_job()方法将完全相同的XML配置重新推送至对应任务，该操作会触发完整的配置保存流程，大部分场景下可直接激活Webhook

方案二：模拟UI保存请求（100%兼容所有插件版本）

如果方案一不生效，可以直接模拟Jenkins UI的Save按钮提交请求，参考代码如下：

import requests

# 替换为你自己的Jenkins配置信息
JENKINS_BASE_URL = "http://你的Jenkins服务地址"
TARGET_JOB_NAME = "刚创建的Jenkins任务名"
JENKINS_USER = "你的Jenkins登录账号"
JENKINS_API_TOKEN = "你的Jenkins API令牌"

# 获取CSRF凭证，避免Jenkins拦截请求
crumb_response = requests.get(
    f"{JENKINS_BASE_URL}/crumbIssuer/api/json",
    auth=(JENKINS_USER, JENKINS_API_TOKEN)
)
crumb_data = crumb_response.json()
csrf_header = {crumb_data["crumbRequestField"]: crumb_data["crumb"]}

# 提交保存请求，触发配置生效逻辑
save_response = requests.post(
    f"{JENKINS_BASE_URL}/job/{TARGET_JOB_NAME}/configSubmit",
    headers=csrf_header,
    auth=(JENKINS_USER, JENKINS_API_TOKEN),
    data={"json": "{}"}
)

if save_response.status_code in (200, 302):
    print("任务配置已重新保存，Bitbucket Webhook已激活")