Jenkins流水线Bitbucket触发时checkout错误版本 找不到Jenkinsfile求助

问题根因 #

1. webhook参数解析异常：从报错日志里的Posting build status... and ref 'null'可以看出，Bitbucket推送事件携带的分支引用没有被Jenkins正确识别，Jenkins无法明确需要拉取的目标分支，默认拉取了远程仓库最新的提交（刚好对应无Jenkinsfile的旧分支）。
2. SCM分支匹配规则过于宽泛：你当前配置的待构建分支规则为**，会匹配仓库所有分支，Jenkins在无明确目标分支的情况下，不会优先筛选存在Jenkinsfile的分支，会直接按远程分支更新时间/字母序取第一个匹配的提交。

修复方案 #

• 方案一：缩小SCM分支匹配范围
  直接将待构建分支规则从**修改为仅匹配存在Jenkinsfile的分支，比如你只有main、dev以及feature/开头的新分支存放Jenkinsfile，可配置为^(?i)(main|dev|feature/.*)$，直接把所有历史旧分支排除在匹配范围外，从根源避免拉取到无Jenkinsfile的分支提交。
• 方案二：显式传递webhook分支参数
  1. 给Jenkins流水线新增一个字符串类型参数TARGET_REF，默认值设置为你常用的主干分支名
  2. 在Bitbucket的webhook配置中，将推送事件的ref字段值作为TARGET_REF参数传递给Jenkins
  3. 将Jenkins的待构建分支规则修改为${TARGET_REF}，强制Jenkins使用webhook传递的分支拉取代码
• 方案三：替换为多分支流水线任务
  如果你后续会在多个新分支存放Jenkinsfile，建议直接把当前普通流水线任务替换为「多分支流水线」类型：
  1. 多分支流水线会自动扫描仓库所有分支，仅为存在Jenkinsfile的分支创建对应的构建子任务
  2. webhook触发时会自动匹配到对应分支的子任务，完全不会出现分支拉取错误的问题

验证方法 #

你可以先临时将待构建分支规则设置为你当前要测试的具体分支名（比如main），推送代码验证构建是否正常，如果不再拉取旧分支提交，即可确认是分支匹配规则的问题。

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