Jenkins Freestyle项目中MSBuild执行报错排查求助

从你提供的完整构建日志来看，核心问题非常明确：

MSBUILD : error MSB1009: 项目文件不存在。
开关: Tappisafe.Web.sln

下面是一步步排查和解决的思路，按优先级来：

1. 先确认SLN文件是否真的在工作区里 #

Jenkins的工作区路径是C:\Windows\system32\config\systemprofile\AppData\Local\Jenkins\.jenkins\workspace\TAPPISAFE-Pipeline，你需要登录到Jenkins所在的Windows服务器，手动导航到这个目录，检查两件事：

• Tappisafe.Web.sln文件是否存在
• 文件名的大小写、拼写是否和你在MSBuild步骤里输入的完全一致（Windows虽然大小写不敏感，但偶尔Git克隆下来的文件名可能有细微差异）

如果文件不在根目录，而是在子文件夹（比如src目录下），那你当前用的相对路径Tappisafe.Web.sln肯定找不到，得改成对应的相对路径（比如src/Tappisafe.Web.sln）或者完整的绝对路径。

2. 检查Jenkins服务的运行账户权限 #

Jenkins默认用Local System账户运行，这个账户的工作区藏在systemprofile目录下，有时候会遇到文件系统权限问题：Git虽然显示克隆成功，但实际文件没有被正确写入，或者MSBuild没有权限读取。

解决方法很简单：

• 打开Windows服务管理器，找到Jenkins服务，右键选「属性」
• 切换到「登录」标签页，改成一个有本地管理员权限的本地账户或域账户
• 重启Jenkins服务，重新跑一次构建，再检查工作区里的文件

3. 确认MSBuild版本是否适配你的项目 #

你当前用的是.NET Framework 4.0版本的MSBuild（路径是C:\Windows\Microsoft.NET\Framework\v4.0.30319\msbuild.exe），这个版本比较老，如果你的Tappisafe.Web.sln是用Visual Studio 2017及以上版本创建的，旧版MSBuild可能不识别新的项目格式，甚至会抛出“文件不存在”的错误（虽然实际文件是存在的）。

建议你：

• 安装对应Visual Studio版本的Build Tools（比如VS2022 Build Tools）
• 在Jenkins的「全局工具配置」里，添加新版本MSBuild的路径（一般在C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\msbuild.exe）
• 在构建步骤里选择这个新版本的MSBuild来执行编译

4. 验证Git克隆的完整性 #

虽然日志里显示Git克隆成功，但还是要手动验证一下：在服务器上打开命令行，执行git clone https://agile.tappi.org/gitbucket/git/root/TAPPISAFE.git到一个临时文件夹，看看SLN文件是否存在。如果手动克隆也没有，那问题出在Git仓库本身——要么这个文件不在master分支，要么仓库里根本没有这个文件，得去Git仓库里确认分支和文件情况。

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