Azure DevOps部署Windows Service任务目标路径异常排查

核心问题原因 #

你遇到的矛盾报错（直接部署提示文件已存在、clean安装提示文件未找到），本质是Windows Service Manager@4任务在未指定目标路径时的默认逻辑混乱，结合新部署组代理的本地环境差异导致：

• 旧部署组代理首次部署时，任务自动根据系统环境（如磁盘空间、注册表记录）生成了C/E盘的默认安装路径，后续部署沿用该路径。
• 新代理的系统环境（如默认磁盘选择、无历史安装记录）导致任务选择的默认路径与实际预期不符：直接部署时，任务试图往某个路径复制文件，但该路径已有残留文件；clean安装时，任务又去另一个不存在的路径查找文件，引发报错。

解决步骤 #

1. 显式指定目标路径（最直接的解决方法） #

在YAML任务中添加TargetPath参数，明确每个部署组的安装路径，彻底避免依赖默认逻辑。可通过部署组变量实现不同组的路径区分：

steps:
- task: MDSolutions.WindowsServiceManagerWindowsServiceManager.WindowsServiceManager.WindowsServiceManager@4
  displayName: 'Deploy Windows Service'
  inputs:
    DeploymentType: DeploymentGroup
    ServiceName: My.Portal.Service
    ArtifactPath: '$(System.DefaultWorkingDirectory)/_Portal.UI/My.Portal.UI/winservice'
    TargetPath: '$(ServiceInstallPath)' # 给不同部署组设置对应的变量值（C:\xxx或E:\xxx）
    TimeOut: 600

设置方法：在Azure DevOps部署组的变量中，为C盘组添加ServiceInstallPath=C:\Services\My.Portal.Service，E盘组添加ServiceInstallPath=E:\Services\My.Portal.Service。

2. 清理新代理的系统残留 #

登录新部署组代理的机器，执行以下操作：

• 检查注册表：打开regedit，定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\My.Portal.Service，查看ImagePath值是否指向错误路径，若存在错误记录，删除该服务项。
• 删除残留文件：手动检查任务可能默认使用的路径（如C:\Program Files下的服务目录、代理工作目录），删除相关残留文件。
• 卸载残留服务：打开管理员权限的命令提示符，执行sc delete My.Portal.Service删除可能存在的无效服务。

3. 验证代理账户权限 #

确认新部署组代理的运行账户对指定的安装路径有读写、创建目录的权限，避免因权限不足导致文件复制失败，出现假的“文件已存在”或“文件未找到”报错。

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