要实现Jenkins自动构建需完成三步：安装Pipeline、Git、JUnit及对应平台插件并重启；创建流水线任务并配置含拉取、测试、报告三阶段的脚本；配置Git webhook触发，确保Jenkins地址可被Git平台访问。
要让Jenkins在代码提交后自动拉取、编译、测试并报告结果，必须完成三件事：装对插件、写对流水线脚本、连通Git与Jenkins的触发链路。缺一不可，否则构建永远卡在“等推送”状态。
安装必需插件
进入 Manage Jenkins → Plugins → Available plugins，搜索并勾选安装以下插件：
Pipeline（流水线语法核心）、Git（拉取代码）、JUnit（解析测试报告）、GitLab Plugin 或 GitHub Plugin（按你用的平台二选一）。
安装完成后必须重启Jenkins，否则Pipeline类型任务创建时会报错“找不到agent定义”。
创建并配置流水线任务
点击左侧 新建任务 → 输入名称（如 auto-test-pipeline）→ 选择 流水线（Pipeline） → 点击确定。
在任务配置页，向下滚动到 Pipeline 区域 → Definition 下拉选 Pipeline script → 粘贴以下最小可用脚本：
pipeline {
agent any
stages {
stage('拉取') { steps { git 'https://your-git-repo-url.git' } }
stage('测试') { steps { sh 'python -m pytest tests/ --junit-xml=report.xml' } }
stage('报告') { steps { junit 'report.xml' } }
}
}
注意替换脚本中 https://your-git-repo-url.git 为真实仓库地址；若仓库私有，需提前在 Credentials 中添加用户名密码或SSH密钥凭证。
配置Git自动触发
第一步：在Jenkins任务配置页 → 构建触发器 → 勾选 GitHub hook trigger for GITScm polling（GitHub）或 GitLab webhook trigger（GitLab）。
第二步：前往你的Git平台项目设置 → 找到 Webhooks → 新建 webhook：
① URL 填入 Jenkins 任务配置页中刚勾选触发器后显示的完整回调地址（形如 http://jenkins-ip:8080/project/auto-test-pipeline/）；
② Secret token 留空或填入任务配置页中“高级”里生成的 token（GitLab 必填，GitHub 可不填）；
③ 触发事件勾选 Push events 和 Tag push events；
④ 点击 Add webhook 并测试发送。
这一步失败最常见原因是 Jenkins 地址对外不可达——确保 Git 平台能通过公网或内网访问到你填的 URL，不能是 localhost 或 127.0.0.1。
验证自动构建是否生效
方法一：在 Git 仓库任意分支提交一次空变更：git commit --allow-empty -m "trigger build" → git push；
方法二：直接在 Jenkins 任务页点击 立即构建，观察控制台输出是否完整执行了拉取→测试→报告三阶段；
方法三：回到 Git 平台 Webhook 页面，点击 Test 按钮，查看 Jenkins 构建历史是否新增一条记录且状态为 成功。
