MSBuild如何配置跨项目目标依赖解决dotnet build首次构建报错

问题结论 #

MSBuild不支持直接跨项目声明自定义目标的依赖关系。默认情况下ProjectReference仅保证被引用项目的默认构建目标（通常是Build）执行完成，不会感知你通过BeforeTargets/AfterTargets挂载的自定义扩展目标，这也是dotnet build并行调度时出现时序问题的核心原因：两个项目分属不同的MSBuild项目上下文，同生命周期阶段的自定义目标会被并行执行，没有强制先后约束。

可行落地方案 #

以下两种方案都可以彻底解决并行构建的时序问题，优先推荐第一种，侵入性更低。

方案1：将自定义目标纳入正式构建依赖链

核心思路是把两个自定义目标从松散的BeforeTargets/AfterTargets挂载，改为加入MSBuild官方的构建依赖属性链，同时显式声明目标的输入输出，让MSBuild能正确识别产出、做增量构建、保证执行顺序。

1. 调整API项目配置：把生成OpenAPI定义的目标从AfterBuild挂载改为加入BuildDependsOn链，声明输出的openapi.json是项目构建产出的一部分：

   <Project Sdk="Microsoft.NET.Sdk.Web">
     <PropertyGroup>
       <!-- 将生成OpenAPI的目标纳入正式构建依赖，Build目标执行完成前必须跑完该目标 -->
       <BuildDependsOn>
         $(BuildDependsOn);
         GenerateApiDefinition
       </BuildDependsOn>
       <!-- 固定OpenAPI文件输出路径 -->
       <OpenApiOutputPath>$(ProjectDir)openapi.json</OpenApiOutputPath>
     </PropertyGroup>
   
     <!-- 声明输入为编译输出的DLL，输出为openapi.json，支持增量构建 -->
     <Target Name="GenerateApiDefinition"
             Inputs="$(TargetPath)"
             Outputs="$(OpenApiOutputPath)">
       <!-- 原有NSwag生成OpenAPI的命令，输出路径使用上面定义的$(OpenApiOutputPath) -->
       <Exec Command="nswag run nswag.nswag /variables:Configuration=$(Configuration),OutPath=$(OpenApiOutputPath)" />
     </Target>
   </Project>
   

2. 调整测试项目配置：把生成客户端的目标加入CompileDependsOn链（保证在C#代码编译前执行），不要挂载到BeforeBuild，同时在目标内动态将生成的客户端文件加入编译列表：

   <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
       <!-- 将生成客户端的目标纳入编译依赖，核心编译步骤启动前必须跑完 -->
       <CompileDependsOn>
         GenerateApiClient;
         $(CompileDependsOn)
       </CompileDependsOn>
       <ApiOpenApiPath>..\ApiProject\openapi.json</ApiOpenApiPath>
       <GeneratedClientPath>$(ProjectDir)Generated\ApiClient.g.cs</GeneratedClientPath>
     </PropertyGroup>
   
     <ProjectReference Include="..\ApiProject\ApiProject.csproj" />
   
     <!-- 声明输入为API项目生成的OpenAPI文件，输出为生成的客户端类 -->
     <Target Name="GenerateApiClient"
             Inputs="$(ApiOpenApiPath)"
             Outputs="$(GeneratedClientPath)">
       <!-- 原有NSwag生成C#客户端的命令 -->
       <Exec Command="nswag openapi2csclient /input:$(ApiOpenApiPath) /output:$(GeneratedClientPath) /namespace:ApiTest.Clients" />
       <ItemGroup>
         <!-- 动态将生成的文件加入编译项，避免提前引用不存在的文件报错 -->
         <Compile Include="$(GeneratedClientPath)" />
       </ItemGroup>
     </Target>
   </Project>
   

这种配置下，MSBuild会识别到测试项目的编译步骤依赖GenerateApiClient的输出，而GenerateApiClient的输入是API项目的构建产出openapi.json，并行调度时会自动等待依赖项就位再执行，不会出现时序问题。

方案2：显式调用被引用项目的目标（100%强制顺序）

如果因为SDK版本差异，方案1仍然存在调度问题，可以直接在测试项目的生成客户端目标里，通过内置的<MSBuild>任务显式触发API项目的GenerateApiDefinition目标，完全绕开并行调度的时序问题：
只需要修改测试项目的GenerateApiClient目标即可：

<Target Name="GenerateApiClient"
        Outputs="$(GeneratedClientPath)">
  <!-- 显式触发API项目的OpenAPI生成目标，等待执行完成后再往下走 -->
  <MSBuild Projects="..\ApiProject\ApiProject.csproj"
           Targets="GenerateApiDefinition"
           Properties="Configuration=$(Configuration)" />
  <!-- 此时openapi.json必然已经生成，再执行客户端生成逻辑 -->
  <Exec Command="nswag openapi2csclient /input:$(ApiOpenApiPath) /output:$(GeneratedClientPath) /namespace:ApiTest.Clients" />
  <ItemGroup>
    <Compile Include="$(GeneratedClientPath)" />
  </ItemGroup>
</Target>

这种方式的执行顺序是完全强制的，和是否并行构建无关，缺点是如果API项目已经构建完成，会多做一次目标存在性检查，但因为加了Inputs/Outputs增量构建配置，不会重复执行NSwag命令，性能影响可以忽略。

避坑说明 #

• 不要依赖BeforeBuild/AfterBuild这种隐式挂载点做核心构建逻辑：这类挂载点是为轻量扩展设计的，不会被纳入核心依赖链，并行构建时调度优先级没有保障。
• 所有生成文件的自定义目标都要加Inputs/Outputs属性：既可以开启增量构建减少重复执行耗时，也能让MSBuild正确识别目标的依赖关系和产出。
• 自动生成的代码文件不要提前在项目中硬编码引用：要在生成目标执行时动态加入Compile项，避免目标还未执行，编译步骤就先检查文件存在性抛出错误。

内容的提问来源于stack exchange，提问作者Thorkil Holm-Jacobsen