MSBuild偶发错误复制相似名称类库致WCF项目构建失败

问题现象 #

• 日常通过MSBuild命令行构建含多个WCF项目的解决方案，失败概率约70%，失败完全随机，无固定规律
• 失败发生在CopyAllFilesToSingleFolderForPackage步骤：MSBuild错误尝试复制未被当前服务引用的Example.Library.dll
• 构建成功时，会正确复制被依赖的Example.Library.Extensions.dll（该类库为解决方案内项目，通过项目引用关联，是支持类的依赖项）

环境与已尝试操作 #

• 涉及VS Build Tools 2019（已升级至最新版）、VS Build Tools 2022，均出现此问题
• 使用的构建命令：

msbuild.exe solution.sln /p:Configuration=Release 
/p:BuildProjectReferences=True /t:"Restore;Build" 
/p:IntermediateOutputPath="C:\temp" /p:DeployOnBuild=True 
/p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem 
/p:DeleteExistingFiles=True /p:publishUrl="C:\publish"

• 已尝试更换不同的Intermediate输出路径，问题未解决

排查与解决建议 #

1. 校验项目引用准确性 #

• 检查WCF项目的间接依赖：确认是否通过其他类库的传递引用引入了Example.Library.dll
• 打开WCF项目的.csproj文件，排查是否存在错误的<Reference>或<ProjectReference>节点，重点核对涉及Example.Library的条目

2. 强制依赖文件名唯一性 #

• 在Example.Library.Extensions项目的.csproj中添加配置，锁定输出文件名，避免MSBuild模糊匹配：

<PropertyGroup>
  <AssemblyName>Example.Library.Extensions</AssemblyName>
  <OutputName>Example.Library.Extensions</OutputName>
</PropertyGroup>

• 同步检查Example.Library项目的输出配置，确保其OutputName未被意外修改

3. 拆分构建与发布流程 #

• 避免单命令同时执行Restore、Build、Publish，拆分步骤减少并行依赖解析冲突：

# 还原依赖
msbuild.exe solution.sln /t:Restore /p:Configuration=Release /p:IntermediateOutputPath="C:\temp"

# 全量构建解决方案
msbuild.exe solution.sln /t:Build /p:Configuration=Release /p:BuildProjectReferences=True /p:IntermediateOutputPath="C:\temp"

# 逐个发布WCF项目
msbuild.exe WcfProject1.csproj /t:WebPublish /p:Configuration=Release /p:DeployOnBuild=True /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="C:\publish\WcfProject1"
msbuild.exe WcfProject2.csproj /t:WebPublish /p:Configuration=Release /p:DeployOnBuild=True /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="C:\publish\WcfProject2"

4. 构建前清理残留文件 #

• 在构建脚本开头添加清理步骤，避免旧文件干扰依赖解析：

rmdir /s /q "C:\temp"
rmdir /s /q "C:\publish"
mkdir "C:\temp"
mkdir "C:\publish"

5. 禁用并行构建排查 #

• 添加/m:1参数禁用并行构建，验证是否为并行竞争导致的依赖解析错误：

msbuild.exe solution.sln /p:Configuration=Release /p:BuildProjectReferences=True /t:"Restore;Build" /m:1 /p:IntermediateOutputPath="C:\temp" /p:DeployOnBuild=True /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="C:\publish"

若禁用后问题消失，可保持单线程构建或调整项目构建顺序

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