如何排除ASP.NET Core发布中依赖Web项目的冗余资产？

1. 调整Web项目的引用配置 #

修改Migrator.csproj中对Web项目的引用，明确只包含编译所需资产，排除发布时的冗余内容：

<ProjectReference Include="../Common/Common.csproj" />
<ProjectReference Include="../Web/Web.csproj">
  <!-- 仅包含编译和构建必需的资产（如Web项目的程序集） -->
  <IncludeAssets>compile; build</IncludeAssets>
  <!-- 所有依赖资产不传递给下游项目 -->
  <PrivateAssets>all</PrivateAssets>
  <!-- 排除Web项目的内容文件、发布脚本等冗余资产 -->
  <ExcludeAssets>content; nonewwithoutoutput; publish</ExcludeAssets>
</ProjectReference>

2. 强制保留Migrator自身的配置文件 #

为避免Web的appsettings.json覆盖Migrator的配置，在Migrator.csproj中添加以下配置，确保自身配置文件优先被复制：

<Content Update="appsettings.json">
  <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</Content>

3. 兜底清理残留冗余文件（可选） #

如果仍有少量冗余文件（如Web.exe、Web.runtimeconfig.json、Pages目录），可通过PublishFile任务在发布完成后清理：

<Target Name="RemoveRedundantPublishFiles" AfterTargets="Publish">
  <RemoveFiles Files="$(PublishDir)Web*" />
  <RemoveFiles Files="$(PublishDir)Pages/**/*" />
</Target>

原理说明 #

• <IncludeAssets>compile; build</IncludeAssets>：仅引入Web项目编译生成的程序集，保证能访问DbContext等核心类型，不会带入内容文件或发布资产。
• <PrivateAssets>all</PrivateAssets>：阻止Web项目的依赖项被传递到Migrator的发布输出中。
• 兜底任务作为最后防线，清理可能残留的冗余文件。

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