使用dotnet publish遇NETSDK1152错误：同路径重复输出文件

问题场景 #

执行dotnet publish时触发NETSDK1152错误，提示找到多个相对路径相同的发布输出文件——冲突文件同时存在于项目根目录（与.cs文件同级）以及bin输出目录。这些文件已在csproj中配置<CopyToOutputDirectory>Always</CopyToOutputDirectory>，且其他同配置的文件未出现该错误，干净克隆仓库后确认源文件仅存在于项目根目录。

报错信息 #

error NETSDK1152: Es wurden mehrere Ausgabedateien für die Veröffentlichung mit demselben relativen Pfad gefunden:
D:\Dev\Repo\project\3rdPartyDll.dll,
D:\Dev\Repo\project\bin\Debug\net7.0-windows\win-x64\3rdPartyDll.dll
D:\Dev\Repo\project\3rdPartyDll.xml
D:\Dev\Repo\project\bin\Debug\net7.0-windows\win-x64\3rdPartyDll.xml

相关csproj配置 #

<ItemGroup>
  <None Update="Different3rdPartyDll.dll">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
  <None Update="3rdPartyDll.dll">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
  <None Update="3rdPartyDll.xml">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
  <None Update="AnotherDifferentDll.dll">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
  <None Update="AnotherDifferentDll.xml">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
  <None Update="YetAnpotherOne.dll">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
</ItemGroup>

原因分析 #

• 发布阶段，MSBuild会同时收集项目根目录的源文件（因配置了CopyToOutputDirectory）和bin目录下已复制的输出文件，两者均被纳入发布打包集合，导致路径冲突。
• 其他同配置文件未报错，大概率是这类文件未被其他构建逻辑（如依赖引用、自动复制规则）重复纳入发布集合，或文件属性（如是否为嵌入资源、是否被其他项目引用）存在差异。

解决方案 #

1. 排除源文件参与发布 #

在csproj中为冲突文件添加<ExcludeFromPublish>True</ExcludeFromPublish>，仅保留bin目录下的副本参与发布：

<None Update="3rdPartyDll.dll">
  <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  <ExcludeFromPublish>True</ExcludeFromPublish>
</None>
<None Update="3rdPartyDll.xml">
  <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  <ExcludeFromPublish>True</ExcludeFromPublish>
</None>

2. 清理构建输出后重新发布 #

先执行清理命令清除bin目录残留文件，再重新发布：

dotnet clean
dotnet publish

3. 改为嵌入资源（按需选择） #

若第三方DLL无需作为独立文件发布，可将其改为嵌入资源，移除复制配置：

<EmbeddedResource Update="3rdPartyDll.dll" />
<EmbeddedResource Update="3rdPartyDll.xml" />

4. 检查隐式引用 #

确认3rdPartyDll.dll是否通过NuGet或项目引用间接引入，若存在这种情况，可移除csproj中的手动复制配置，依赖引用的自动复制逻辑。

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