核心思路是停用轮询scm、改用webhook事件驱动，并优化git服务端配置以缓解接口限流。具体包括：禁用“轮询scm”，在git平台配置指向jenkins的webhook；调整多分支索引频率至每天一次或禁用；限定分支发现模式，避免全量扫描；为jenkins出口ip和专用token配置git平台白名单与高配额；启用git插件本地缓存及构建降级机制。
核心思路是降低扫描频率、改用事件驱动触发，并优化 Git 服务端配置，避免轮询造成接口压力。
调整扫描策略：停用轮询，启用 Webhook
轮询（Poll SCM）是导致 Git 接口被限流的主因。应彻底停用，改用 Git 平台（如 GitHub/GitLab/Gitee）的 Webhook 主动推送事件。
- 在 Jenkins 多分支流水线项目中，进入 配置 → 构建触发器，取消勾选 “轮询 SCM”
- 在 Git 平台仓库设置里添加 Webhook：
URL 填 Jenkins 的钩子地址（如http://jenkins.example.com/gitlab-webhook/post或http://jenkins.example.com/github-webhook/），内容类型选application/json - 确保 Jenkins 已安装并启用对应插件（如 GitLab Plugin、GitHub Integration Plugin），且系统配置中已正确关联 Git 平台凭证和 URL
优化多分支扫描行为：控制扫描范围与节奏
即使不用轮询，Jenkins 仍会定期执行“索引”（Indexing）来发现新分支或删除失效分支。默认每小时一次，可按需调整。
- 进入项目配置 → 分支源 → 高级 → Scan triggers，将 “Scan every N minutes” 改为更大值（如
1440表示每天一次），或直接禁用（留空） - 在 “Branch discovery” 中，明确限定要扫描的分支模式（如
origin/main、origin/release/*），避免通配符*扫描全部远程引用（包括 tags、pr refs 等非必要项） - 若使用 GitHub/GitLab 组织文件夹（Organization Folder），可启用 “Discover pull requests from origin” 等精细化策略，减少无效扫描
服务端协同：配置 Git 平台速率限制白名单
部分企业 Git 服务（如自建 GitLab、Gitea 或云厂商私有部署）支持对特定 IP 或 Token 设置宽松限流策略。
- 为 Jenkins 服务器分配固定出口 IP，并在 Git 平台后台将其加入 API 调用白名单
- 使用专用高权限 Token（而非个人账号 Token）对接 Jenkins，该 Token 在 Git 平台侧配置更长有效期与更高调用配额
- GitLab 示例：在 Admin Area → Settings → Network → Allowed IPs for API and CI services 添加 Jenkins 服务器 IP
补充建议：启用缓存与降级机制
降低每次扫描的实际请求量，也能缓解限流压力。
- 在 Jenkins 全局配置中启用 Git 插件的本地缓存：Manage Jenkins → System → Git plugin → Enable caching，并设置合理缓存路径与超时时间
- 对于非关键分支（如
feature/*），可在其Jenkinsfile中通过properties([disableConcurrentBuilds()])或跳过部分阶段，缩短扫描后构建链路耗时，间接降低资源占用 - 监控 Jenkins 日志中
hudson.plugins.git.GitSCM和org.jenkinsci.plugins.github_branch_source.GitHubSCMSource相关错误，及时识别限流响应码（如 HTTP 429）并告警
