DevOps Pipeline代码签名失败：PFX证书文件未找到，如何解决？

错误信息 #

Cmd.exe exited with code '1'.
Code Sign x86 DLLs

SignTool Error: File not found: D:\DevOpsAgent\Agent02\_work_63\s\Code Signing Certificate\abcd-csc-2024.pfx

排查步骤 #

• 核对Get Sources执行日志

  • 确认该步骤是否成功拉取目标.pfx文件，查看日志中是否有该文件的下载记录，排查是否因权限不足、仓库分支切换错误导致文件未同步
  • 检查是否启用了浅克隆或部分拉取策略，导致证书所在目录未被完整拉取

• 验证代理工作目录实际文件结构

  • 在签名任务前新增命令行任务，执行dir "D:\DevOpsAgent\Agent02\_work_63\s\Code Signing Certificate"，列出目录下所有文件，确认证书是否存在
  • 检查签名命令中路径是否因空格未加双引号，导致路径解析错误，建议给包含空格的路径套上双引号："D:\DevOpsAgent\Agent02\_work_63\s\Code Signing Certificate\abcd-csc-2024.pfx"

• 检查任务依赖与执行顺序

  • 确认签名任务是否严格在Get Sources和构建任务之后执行，排查是否因任务并行导致签名启动时证书文件还未完成下载
  • 查看构建任务是否包含清理工作目录的操作，是否误删了证书文件所在目录

• 检查源代码仓库中证书文件状态

  • 确认仓库内Code Signing Certificate/abcd-csc-2024.pfx是否被误删除、重命名，或权限变更导致代理无法拉取
  • 核对最近提交记录，排查是否存在目录名/文件名大小写、空格等隐性变更（即使你认为路径未改）

内容的提问来源于stack exchange，提问作者Theodosius Von Richthofen