.NET Core 7发布时webroot仅二次运行复制的问题及方案验证

问题根源 #

你遇到的问题核心是MSBuild的目标执行顺序：默认情况下，dotnet publish会先执行内容收集（比如CollectFilesFromContent步骤），再执行Build目标。而你之前把npm构建命令挂在Build之后，导致第一次publish时，webroot还未生成（或刚被npm run build删除重建），内容收集步骤自然拿不到文件；第二次执行时webroot已存在，才能被正常收集。

最优解决方案 #

通过调整MSBuild目标的依赖关系，让npm构建步骤优先于发布流程的内容收集阶段执行，同时利用增量构建特性避免重复执行不必要的npm命令。

在你的项目csproj文件中添加以下配置：

<!-- 扩展Publish的依赖链，让NpmBuild在发布前执行 -->
<PropertyGroup>
  <PublishDependsOn>$(PublishDependsOn);NpmBuild</PublishDependsOn>
</PropertyGroup>

<!-- 定义NpmBuild目标，处理npm install和build -->
<Target Name="NpmBuild" 
        Inputs="package.json;package-lock.json;ClientApp/**/*" <!-- 客户端源码和依赖文件作为输入 -->
        Outputs="$(WebRootPath)/index.html"> <!-- 客户端构建产物作为输出，用于增量构建 -->
  
  <!-- 仅当node_modules不存在时执行npm install，优化构建速度 -->
  <Exec Command="npm install" 
        WorkingDirectory="$(ProjectDir)" 
        Condition="!Exists('$(ProjectDir)node_modules')" />

  <!-- 执行npm build生成webroot -->
  <Exec Command="npm run build" 
        WorkingDirectory="$(ProjectDir)" />
</Target>

<!-- 确保webroot文件被复制到发布目录 -->
<ItemGroup>
  <Content Include="webroot/**/*" CopyToPublishDirectory="PreserveNewest" />
</ItemGroup>

配置说明 #

1. PublishDependsOn扩展：将NpmBuild加入发布流程的依赖链，确保它在发布的核心步骤（包括内容收集）之前执行，从根源解决时序问题。
2. 增量构建优化：通过Inputs和Outputs指定目标的输入输出文件，MSBuild会自动检测文件变化，只有当客户端源码或依赖文件更新时，才重新执行npm命令，避免无意义的重复构建。
3. 条件化npm install：添加Condition判断，仅在node_modules不存在时才执行npm install，进一步提升构建效率。
4. Content项配置：使用CopyToPublishDirectory="PreserveNewest"确保webroot文件在发布时被复制，且只更新有变化的文件。

对比拆分Target方案 #

如果你的拆分方案是将npm构建从Build后移到发布前的阶段，思路是正确的，但上述配置更贴合MSBuild的设计规范，同时加入了增量构建优化，是更高效、可维护的实现方式。

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