Azure DevOps Windows管道代理发布静态Web应用失败（退出码127）

问题场景 #

• 已部署Windows版Azure DevOps管道代理并以服务运行，代理用户对C:\agent文件夹配置了全员完全控制权限
• 代理与DevOps平台通信正常，Git检出步骤执行无异常
• 发布Azure静态Web应用步骤失败，错误日志如下：

C:\Windows\system32\bash.exe C:\agent_work_tasks\AzureStaticWebApp_18aad896-e191-4720-88d6-8ced4806941a\0.248.1\launch-docker.sh
/bin/bash: C:agent_work_tasksAzureStaticWebApp_18aad896-e191-4720-88d6-8ced4806941a0.248.1launch-docker.sh: No such file or directory

• 手动使用代理用户启动C:\Windows\system32\bash.exe可正常进入脚本目录，修改launch-docker.sh添加pwd和echo命令后，管道日志未出现相关输出

排查步骤与解决建议 #

1. 修复Windows路径在Bash中的转义问题 #

错误日志中路径反斜杠丢失，是因为Windows路径的反斜杠在Bash中被识别为转义字符。可尝试两种解决方式：

• 将Windows路径转换为WSL兼容格式，调用命令改为：

  C:\Windows\system32\bash.exe /c/agent/_work/_tasks/AzureStaticWebApp_18aad896-e191-4720-88d6-8ced4806941a/0.248.1/launch-docker.sh
  

• 给路径添加引号避免转义丢失，调用命令改为：

  C:\Windows\system32\bash.exe "C:\agent\_work\_tasks\AzureStaticWebApp_18aad896-e191-4720-88d6-8ced4806941a\0.248.1\launch-docker.sh"
  

2. 排查代理服务与手动执行的环境差异 #

代理以服务运行时的环境变量、工作目录可能和手动启动bash不同：

• 打开服务管理器，找到Azure DevOps代理服务，确认「登录」标签页的用户与手动测试的用户完全一致（区分本地用户/域用户）
• 将代理服务改为手动启动，停止服务后，用代理用户打开命令提示符执行run.cmd启动代理，再触发管道测试。若手动启动代理能成功，说明服务环境存在配置问题
• 在管道中添加步骤输出环境变量，对比手动bash的环境变量差异，重点检查PATH、HOME等核心变量

3. 验证脚本文件的实际访问权限 #

即使文件夹配置了全员权限，单个文件可能存在继承权限异常：

• 右键launch-docker.sh文件，进入「属性」-「安全」，确认代理用户拥有「读取和执行」权限（需直接检查文件权限，而非仅依赖文件夹权限）
• 复制launch-docker.sh到C:\temp目录，修改管道任务调用该副本，测试是否能正常执行，排除原目录的权限或路径问题

4. 检查WSL配置与兼容性 #

若代理依赖WSL运行，可能存在路径映射bug：

• 打开bash执行wsl --list --verbose，确认默认WSL发行版正常运行
• 在bash中执行ls /c/agent/_work/_tasks/AzureStaticWebApp_18aad896-e191-4720-88d6-8ced4806941a/0.248.1/launch-docker.sh，验证文件是否可被访问
• 执行wsl --update更新WSL到最新版本，修复已知的路径映射问题

5. 切换Azure静态Web应用任务版本 #

当前使用的任务版本（0.248.1）可能存在Windows环境下的路径bug：

• 在管道编辑器中，将Azure Static Web App任务切换到最新稳定版本，或降级至之前验证正常的版本，重新运行管道测试

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