TFS Build执行Robocopy返回错误码1但实际执行正常问题

这是个很常见的Robocopy和CI/CD工具兼容性问题，核心原因是Robocopy的退出码逻辑和传统命令行工具完全不同——它用位掩码表示执行状态，不是简单的「0=成功、非0=失败」。

问题原因分析 #

从你提供的执行日志能明确看到：

2019-02-27T10:21:58.3234459Z Files : 6107 6 6101 0 0 0

Robocopy成功复制了6个文件，此时它返回的退出码1在Robocopy的规则里是正常状态，代表「至少有一个文件被成功复制」。但TFS Build默认会把所有非0的退出码判定为任务失败，所以才会弹出##[error]Process completed with exit code 1的错误提示。

Robocopy的核心退出码规则（关键部分）：

• 0：无文件复制，也无任何错误
• 1：成功复制了至少一个文件
• 2：跳过了部分文件
• 8：出现复制失败/错误（真正需要关注的异常）
• 16：严重错误（比如源/目标路径不存在）

解决方案 #

推荐通过命令行逻辑精准判断Robocopy的退出码，只在出现真正的错误（退出码>8）时才让TFS Build判定为失败，否则返回0表示任务成功。

方法1：修改命令行任务的执行命令

把你的Robocopy命令改成以下批处理形式：

robocopy [源路径] [目标路径] [你的参数]
:: 仅当退出码大于8时才返回错误，否则返回0
if %ERRORLEVEL% GTR 8 exit /b %ERRORLEVEL% else exit /b 0

方法2：改用PowerShell任务执行（如果适用）

如果你的TFS Build任务支持PowerShell，可以这样处理：

robocopy [源路径] [目标路径] [你的参数]
# 判断Robocopy的退出码，仅大于8时抛出错误
if ($LASTEXITCODE -gt 8) { exit $LASTEXITCODE } else { exit 0 }

方法3：调整任务的退出码行为（不推荐）

你也可以在TFS Build的命令行任务设置里，找到「退出代码行为」选项，设置为「即使退出代码非零也成功」。但这种方法会忽略所有错误（包括真正的复制失败），只适合你能确保Robocopy不会出现严重异常的场景。

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