如何解决Jenkins调用VS 2017构建工具时的‘Java...此时意外’错误？

这个问题我之前处理过好几次，本质是VS2017的命令行脚本和Jenkins的Java环境变量冲突导致的——VS2017开始微软把旧版的VsMSBuildCmd.bat整合到了VsDevCmd.bat中，这个新脚本在解析环境变量时，对带空格的路径处理逻辑有瑕疵，而Jenkins依赖的Java路径（比如JAVA_HOME）通常包含空格（比如C:\Program Files\Java\jdkxxx），直接调用就会触发语法错误。

下面是我亲测有效的解决方案：

1. 确认VS2017脚本的正确路径 #

VS2017的命令行初始化脚本路径会根据你的VS版本（Community/Professional/Enterprise）略有差异，比如专业版的路径是：

C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\Tools\VsDevCmd.bat

建议不要用环境变量存储这个路径，直接使用带引号的完整路径调用，避免环境变量解析时的空格问题。

2. 用setlocal隔离环境并调用脚本 #

在Jenkins的bat步骤里，通过setlocal和endlocal创建局部环境，避免VS的环境变量污染Jenkins全局环境，同时给脚本路径加上引号确保空格被正确解析：

setlocal
:: 替换成你服务器上VS2017的VsDevCmd.bat实际路径
call "C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\Tools\VsDevCmd.bat"
:: 执行你的msbuild任务，替换成自己的项目和参数
msbuild YourProject.sln /p:Configuration=Release /p:Platform=x64
endlocal

3. 优化Jenkins的Java环境变量（可选兜底方案） #

如果上面的方法还没解决问题，可以把Jenkins使用的Java路径改为短路径（Windows的8.3格式）：

• 比如将C:\Program Files\Java\jdk1.8.0_301替换为C:\Progra~1\Java\jdk1.8.0_301
• 在Jenkins的「全局工具配置」中，把JDK的安装路径设置为这个短路径，这样JAVA_HOME就没有空格了，VS脚本也就不会触发解析错误。

4. 本地验证排查 #

如果还是有问题，可以先在Jenkins服务器的本地cmd里运行同样的VS脚本命令：

• 如果本地也报错，说明是服务器本身的环境变量有问题，重点检查JAVA_HOME、PATH里的带空格路径是否未正确转义
• 如果本地正常，那就是Jenkins进程的环境变量和登录用户环境变量不一致，可以在Jenkins的bat步骤里先输出echo %JAVA_HOME%和echo %PATH%，对比排查差异

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