如何解决MSBuild重复导入.targets文件触发MSB4011警告的问题

问题根因 #

MSBuild 默认存在同路径目标文件重复导入校验机制，同一文件路径只会被导入一次。你现在每个业务模块的Module.targets都导入了相同路径的/Base/Module.targets，只有第一个模块导入时基础文件会生效，后续模块导入时基础文件直接被忽略，会导致对应模块的程序集引用、Database.json配置均无法正确加载。

另外要注意，你当前用Project作为自定义属性名，可能和MSBuild内置的$(Project)属性冲突，建议后续改为ProjectName避免未知问题。

解决方案 #

方案一（改动最小，推荐） #

在每个业务模块导入基础文件的语句中，添加随模块变化的查询参数，让MSBuild判定为不同的导入源，跳过重复导入校验。
以Customers模块为例，修改导入语句为：

<Import Project="/Base/Module.targets?Module=$(Module)" />

所有模块都按上述格式修改导入语句即可，因为每次查询参数的$(Module)值不同，MSBuild不会触发重复导入拦截，每个模块的配置都会正常生效。

方案二（结构更规范） #

将基础Module.targets的逻辑封装为带参数的可调用目标，从根源避免重复导入问题：

1. 修改基础Module.targets内容，把配置逻辑放入带参数的Target中：

<Project>
  <Target Name="AddModuleReferencesAndContent">
    <ItemGroup>
      <Reference Include="$(ProjectName).$(ModuleName).Models">
        <HintPath>/$(ProjectName)/$(ModuleName)/Packages/$(ProjectName).$(ModuleName).Models.dll</HintPath>
        <Private>True</Private>
      </Reference>
      <Reference Include="$(ProjectName).$(ModuleName).DataAccess">
        <HintPath>/$(ProjectName)/$(ModuleName)/Packages/$(ProjectName).$(ModuleName).DataAccess.dll</HintPath>
        <Private>True</Private>
      </Reference>
      <Reference Include="$(ProjectName).$(ModuleName).Business">
        <HintPath>/$(ProjectName)/$(ModuleName)/Packages/$(ProjectName).$(ModuleName).Business.dll</HintPath>
        <Private>True</Private>
      </Reference>
    </ItemGroup>
    
    <ItemGroup>
      <Content Include="/$(ProjectName)/$(ModuleName)/Database.json">
        <Link>Database\$(ModuleName).json</Link>
        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
      </Content>
    </ItemGroup>
  </Target>
</Project>

2. 在你的API项目最开始只导入一次基础文件：

<Import Project="/Base/Module.targets" />

3. 每个业务模块的Module.targets删除原有导入基础文件的语句，改为调用目标传参，以Customers模块为例：

<PropertyGroup>
    <ProjectName>CRM</ProjectName>
    <ModuleName>Customers</ModuleName>
</PropertyGroup>
<MSBuild Projects="$(MSBuildThisFileFullPath)" Targets="AddModuleReferencesAndContent" Properties="ProjectName=$(ProjectName);ModuleName=$(ModuleName)" />

验证方法 #

修改完成后重新编译项目，检查：

• 输出目录下的Database文件夹是否存在所有模块对应的json文件
• 项目引用列表是否包含所有模块的Models、DataAccess、Business程序集
• 无MSB4011警告

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