配置checkout: self后Azure流水线仍跳过仓库源同步该如何处理

1. 校验仓库访问权限与触发规则 #

• 确认 pipeline 运行所用的服务身份对目标仓库有 读取权限，跨项目引用的仓库需额外配置跨项目访问授权，无读取权限会直接触发跳过同步逻辑。
• 检查 pipeline 触发规则的路径过滤配置，若提交路径全部落在排除路径范围内，会被判定为无需要同步的代码变更，触发跳过提示。

2. 核对 YAML 配置层级正确性 #

checkout: self 必须放置在对应 job 的 steps 层级下，若在全局配置了 checkout: none 会覆盖 job 级别的配置，正确配置示例如下：

jobs:
- job: maven_build
  steps:
  - checkout: self # 必须写在当前构建job的steps下
  - task: Maven@3
    inputs:
      mavenPomFile: 'pom.xml'
      goals: 'clean package'

3. 强制清理工作目录缓存 #

若 pipeline 开启了工作目录缓存，可能会因缓存判定跳过源码同步，可在 job 层级添加清理配置，强制清空工作目录：

jobs:
- job: maven_build
  workspace:
    clean: all # 运行前清空所有工作目录文件
  steps:
  - checkout: self
  - task: Maven@3
    inputs:
      mavenPomFile: 'pom.xml'

也可在手动触发 pipeline 时，勾选「清理所有缓存目录」选项临时生效。

4. 显式配置检出参数避免匹配错误 #

若开启了浅克隆、指定了检出标签/分支规则，可能因规则匹配错误跳过同步，可显式指定检出分支与拉取深度：

- checkout: self
  fetchDepth: 1
  ref: 'refs/heads/你的目标分支名'

完成以上配置后重新运行 pipeline 即可正常拉取源码到构建代理，pom.xml 可被后续Maven任务正常识别。

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