多目标.NET Framework 4.7与.NET Standard 2.1时AutoMapper适配问题

可行性结论 #

完全可行，这是.NET跨框架兼容场景下的常规解决方案，通过多目标项目配置+条件编译+条件包引用，可以完美适配AutoMapper的新旧版本需求。

具体实现步骤 #

1. 配置项目多目标框架 #

修改业务层项目的.csproj文件，指定同时面向.NET Framework 4.7和.NET Standard 2.1：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net47;netstandard2.1</TargetFrameworks>
  </PropertyGroup>
</Project>

2. 条件引用AutoMapper版本 #

在.csproj中针对不同目标框架引用对应版本的AutoMapper，比如旧版选8.x（支持.NET Framework 4.x），新版选12.x+（仅支持.NET Standard 2.1+）：

<ItemGroup>
  <!-- .NET Framework 4.7 引用旧版AutoMapper -->
  <PackageReference Include="AutoMapper" Version="8.1.1" Condition="'$(TargetFramework)' == 'net47'" />
  <!-- .NET Standard 2.1 引用新版AutoMapper -->
  <PackageReference Include="AutoMapper" Version="12.0.1" Condition="'$(TargetFramework)' == 'netstandard2.1'" />
</ItemGroup>

3. 设置条件编译常量 #

在.csproj中为不同目标框架定义专属编译常量，方便代码中区分逻辑：

<PropertyGroup>
  <DefineConstants Condition="'$(TargetFramework)' == 'net47'">NET47;AUTOMAPPER_OLD</DefineConstants>
  <DefineConstants Condition="'$(TargetFramework)' == 'netstandard2.1'">NETSTANDARD2_1;AUTOMAPPER_NEW</DefineConstants>
</PropertyGroup>

4. 代码中适配新旧AutoMapper逻辑 #

根据编译常量隔离不同版本的AutoMapper代码，比如配置方式、API调用差异：

using AutoMapper;

public class MappingHelper
{
    public IMapper GetMapper()
    {
#if AUTOMAPPER_OLD
        // 旧版AutoMapper初始化逻辑
        Mapper.Initialize(cfg =>
        {
            cfg.CreateMap<OrderEntity, OrderDto>();
            // 其他旧版映射配置
        });
        return Mapper.Instance;
#else
        // 新版AutoMapper初始化逻辑
        var config = new MapperConfiguration(cfg =>
        {
            cfg.CreateMap<OrderEntity, OrderDto>();
            // 其他新版映射配置
        });
        return config.CreateMapper();
#endif
    }
}

关键注意事项 #

• 最小化条件编译代码：尽量将公共映射逻辑抽离到共享方法中，仅在API差异处使用条件编译，避免代码冗余和维护成本上升。
• 双框架测试：必须分别在.NET Framework 4.7和.NET Standard 2.1环境下进行测试，确保两种目标框架下业务逻辑均正常运行。
• 依赖兼容性：检查业务层其他依赖库是否支持双目标框架，若存在类似AutoMapper的版本兼容问题，同样采用条件引用处理。
• 数据层兼容性：确保业务层对多目标数据层的调用API一致，避免因数据层跨框架差异导致业务层报错。

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