.NET MAUI iOS发布构建中AutoMapper触发JIT编译错误求助

核心原因 #

iOS发布构建采用**AOT（提前编译）**模式，AutoMapper默认的运行时反射生成映射逻辑会触发JIT编译，而AOT模式下禁止JIT，因此抛出错误。本地Debug模式未开启AOT，所以无法复现。

具体解决步骤 #

1. 启用AutoMapper编译时源生成器（推荐） #

使用AutoMapper的源生成器可以在编译阶段直接生成映射代码，完全避免运行时反射：

• 安装NuGet包：确保项目同时安装AutoMapper和AutoMapper.SourceGenerator，保持版本一致（如最新稳定版）。
• 定义映射Profile类：创建继承自Profile的配置类，显式声明所有映射关系：

public class AppMappingProfile : Profile
{
    public AppMappingProfile()
    {
        // 显式定义你的映射
        CreateMap<Class1, Class2>();
        // 其他映射规则
    }
}

• 初始化Mapper：通过MapperConfiguration加载Profile，生成的映射代码会在编译时自动嵌入：

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.AddProfile<AppMappingProfile>();
});
var mapper = mapperConfig.CreateMapper();

2. 禁用运行时反射相关API #

• 避免使用DynamicMap等动态反射API，所有映射必须使用强类型的Map<TSource, TDestination>方法。
• 检查自定义类型转换器、值解析器等扩展，确保它们实现了对应的强类型接口（如ITypeConverter<TSource, TDestination>），并在Profile中显式注册，不要依赖动态扫描。

3. 配置MAUI iOS发布构建参数 #

在项目的.csproj文件中，确保Release配置的AOT和裁剪设置正确：

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-ios|AnyCPU'">
    <AotCompile>true</AotCompile>
    <EnableLLVM>true</EnableLLVM>
    <TrimMode>full</TrimMode>
    <!-- 确保AutoMapper生成的代码不被裁剪 -->
    <TrimmerRootAssembly>AutoMapper</TrimmerRootAssembly>
    <TrimmerRootAssembly>YourProjectName</TrimmerRootAssembly>
</PropertyGroup>

4. 本地模拟发布环境测试 #

切换到Release配置，开启AOT编译运行iOS真机/模拟器，提前验证问题是否解决：

• 在Visual Studio中选择Release配置，目标设备选iOS真机或模拟器。
• 运行项目，执行映射代码，确认无JIT编译错误。

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