.NET 7 Blazor Server发布报错NETSDK1152的根源与正确解法

一、涉事文件的作用 #

• Api.dll.config：这是Api项目的运行时配置文件，包含程序集绑定重定向、自定义配置节等信息，.NET运行时加载Api程序集时会读取该文件，确保依赖程序集能正确加载。
• WebComponents.staticwebassets.runtime.json：这是静态Web资产的运行时清单文件，专为Blazor项目设计，记录了组件CSS、JS、静态文件等资源的位置、哈希值元数据，帮助运行时精准定位并加载静态资源，避免资源丢失或缓存异常。

二、错误原因 #

核心问题出在Api项目被多个子项目重复引用：每个引用Api的子项目在发布时，都会将Api.dll.config复制到输出目录，导致同一文件多次出现；而WebComponents.staticwebassets.runtime.json则是多个项目（比如Web和WebApi）都生成了同名清单文件，触发msbuild命令行发布时的重复文件校验报错。Visual Studio IDE构建时内部做了冲突规避处理，但命令行发布模式会严格检查重复输出文件，因此仅在msbuild命令执行时出现该错误。

三、正确解决方法 #

1. 精准控制引用项目的文件复制行为 #

对于引用Api项目的子项目（如WebApi、Web），修改其csproj文件，调整项目引用配置，避免重复复制Api的配置文件：

<ProjectReference Include="..\Api\Api.csproj">
  <Private>True</Private>
  <IncludeAssets>compile; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  <!-- 禁止复制该引用项目的输出文件到当前项目发布目录 -->
  <CopyToOutputDirectory>Never</CopyToOutputDirectory>
</ProjectReference>

若只想排除特定重复文件，可在引用Api的子项目中添加：

<ItemGroup>
  <Content Remove="Api.dll.config" />
  <None Remove="Api.dll.config" />
</ItemGroup>

2. 禁用不必要的静态资产清单生成 #

检查哪些项目生成了WebComponents.staticwebassets.runtime.json，对于不需要该文件的项目（如纯后端WebApi），在其csproj中添加以下配置，禁止生成该清单：

<PropertyGroup>
  <GenerateStaticWebAssetsRuntimeManifest>false</GenerateStaticWebAssetsRuntimeManifest>
</PropertyGroup>

仅保留主Blazor Server项目（Web）生成该文件，从根源避免重复。

3. 优化项目依赖结构 #

梳理解决方案的依赖关系，移除不必要的Api项目直接引用。例如部分子项目可通过接口定义项目间接依赖Api，减少重复引用场景，自然消除文件重复问题。

4. 单文件发布（可选） #

若应用适合单文件部署模式，可在主项目（Web.csproj）中启用单文件发布，.NET会将所有依赖打包为单个可执行文件，避免文件重复冲突：

<PropertyGroup>
  <PublishSingleFile>true</PublishSingleFile>
  <SelfContained>false</SelfContained> <!-- false表示依赖系统安装的.NET运行时，可根据需求调整 -->
</PropertyGroup>

注意：单文件发布可能影响调试和部分特定功能，需提前测试兼容性。

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