如何让AutoMapper及AutoMapper.Data在AOT构建/发布环境中正常运行？

1. 升级到兼容AOT的版本 #

AutoMapper从12.0版本开始逐步完善AOT支持，AutoMapper.Data也需要匹配对应适配的稳定版本，先将两者升级到最新可用的稳定版，确保基础组件支持AOT环境。

2. 替换自动映射为显式配置 #

AOT模式下禁止运行时反射，必须放弃AutoMapper的自动映射发现能力，手动显式配置所有映射关系：

• 禁用Profile的自动扫描，改为手动注册每个自定义Profile
• 所有CreateMap操作都要显式指定成员映射逻辑，避免依赖自动推断
• 避免使用依赖反射的自定义转换器、动态表达式等特性

示例代码：

var config = new MapperConfiguration(cfg =>
{
    // 手动注册Profile
    cfg.AddProfile<UserProfile>();
    // 显式指定成员映射
    cfg.CreateMap<OrderEntity, OrderDto>()
        .ForMember(dest => dest.OrderNumber, opt => opt.MapFrom(src => src.Id))
        .ForMember(dest => dest.TotalAmount, opt => opt.MapFrom(src => src.Amount));
});

// 编译阶段验证配置有效性，提前发现问题
config.AssertConfigurationIsValid();
var mapper = config.CreateMapper();

3. 启用AutoMapper源生成器 #

使用AutoMapper.SourceGenerator NuGet包，在编译阶段提前生成AOT兼容的映射代码，彻底避免运行时反射：

1. 安装AutoMapper.SourceGenerator包
2. 在项目中用[Mapper]特性标记包含映射配置的类，或者通过MapperGenerator指定配置类
3. 确保所有映射配置都能被源生成器识别

示例：

[Mapper]
public static class AppMappingConfig
{
    public static void Configure(MapperConfigurationExpression cfg)
    {
        cfg.CreateMap<UserEntity, UserDto>();
        cfg.CreateMap<OrderEntity, OrderDto>();
    }
}

4. 适配AutoMapper.Data的DataReader映射 #

AutoMapper.Data的FromDataReader等方法依赖反射，AOT下需要替换为：

• 手动实现DataReader到对象的映射逻辑，直接通过字段索引获取值
• 若必须使用AutoMapper.Data，可借助.NET 7+的UnsafeAccessor特性绕过反射限制，为目标类型生成可访问的成员访问器

示例手动映射DataReader：

public static UserDto MapFromDataReader(IDataReader reader)
{
    return new UserDto
    {
        Id = reader.GetInt32(reader.GetOrdinal("UserId")),
        Username = reader.GetString(reader.GetOrdinal("UserName")),
        Email = reader.IsDBNull(reader.GetOrdinal("Email")) ? null : reader.GetString(reader.GetOrdinal("Email"))
    };
}

5. 优化项目AOT配置 #

在项目文件中添加额外配置，确保AutoMapper相关类型的元数据被保留：

<PropertyGroup>
    <RuntimeIdentifiers>linux-x64</RuntimeIdentifiers>
    <PublishAot>true</PublishAot>
    <PublishTrimmed>true</PublishTrimmed>
    <TrimMode>partial</TrimMode>
</PropertyGroup>

<ItemGroup>
    <!-- 保留AutoMapper核心库的元数据 -->
    <TrimmerRootAssembly Include="AutoMapper" />
    <TrimmerRootAssembly Include="AutoMapper.Data" />
</ItemGroup>

6. 调试定位问题 #

发布后若仍有错误，可通过以下方式排查：

• 运行发布后的可执行文件，定位具体的缺失类型或反射调用点
• 针对报错的类型，添加[DynamicDependency]特性，告知AOT编译器保留该类型的相关成员

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