Pipeline执行报错：找不到Deploy-PolicyPlan.ps1文件（文件实际存在）

1. 核对任务工作目录 #

• 先确认其他正常运行任务的工作目录：查看Pipeline代码里的workingDirectory配置，或者任务执行日志里的当前路径。
• 对比报错任务的工作目录，大概率是该任务的工作路径和其他任务不一致，导致路径解析错误。比如其他任务基于仓库根目录执行，报错任务却在子目录，用了不匹配的绝对路径。

2. 检查路径大小写匹配 #

• Linux/macOS环境下路径大小写敏感，务必核对Pipeline里写的/Scripts/Deploy/Deploy-PolicyPlan.ps1和实际文件的大小写完全一致，比如实际文件名是deploy-policyplan.ps1就会触发报错。
• Windows环境虽默认不敏感，但部分CI/CD工具会严格解析，也建议仔细核对。

3. 加前置命令验证文件存在性 #

• 在报错任务前新增一个命令行任务，打印当前路径并列出目标目录文件，直观确认文件状态：
  若用bash：

  pwd
  ls -la /Scripts/Deploy/
  

  若用PowerShell：

  Get-Location
  Get-ChildItem -Path "/Scripts/Deploy/"
  

4. 排查前置任务的影响 #

• 查看前置任务的执行日志，确认是否有步骤意外移动、删除了Deploy-PolicyPlan.ps1，或者修改了目标目录的权限。比如部分清理类任务可能误删了目标文件。

5. 统一路径配置规则 #

• 检查报错任务是否用了硬编码的绝对路径，而其他任务用的是相对路径。比如其他任务用./Scripts/Deploy/xxx.ps1（基于仓库根目录的相对路径），报错任务却用了/Scripts/Deploy/xxx.ps1（CI环境中绝对路径可能指向非代码仓库目录）。建议统一使用相对路径。

6. 清理CI工作空间缓存 #

• 部分CI/CD工具会缓存工作空间，旧缓存可能导致文件缺失。尝试清理缓存后重新运行Pipeline，同时确认拉取的代码分支确实包含该文件。

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