MAUI iOS发布版用Entity Framework遇NativeAOT模型构建错误求解决

问题背景 #

将应用从Xamarin迁移至MAUI后，iOS Release模式下启用NativeAOT时，Entity Framework Core运行时模型构建会触发报错：Model building is not supported when publishing with NativeAOT. Use a compiled model.。禁用AOT（如设置<UseInterpreter>True</UseInterpreter>）虽能解决问题，但会损失性能；而EF 9实验性的编译模型配置后，应用卡在model.Initialize()步骤无法继续。

可行解决方案 #

方案一：优化EF 9编译模型配置，解决初始化卡死问题 #

EF 9的编译模型虽为实验性特性，但通过调整配置可解决多数卡死场景：

1. 升级至EF 9最新预览版：实验性特性在持续迭代，新版本可能修复初始化卡死的已知问题。
2. 启用编译模型调试日志：在项目文件中添加以下配置，排查卡死的具体原因（如实体映射错误、未处理的类型）：

   <PropertyGroup>
     <EfCoreCompiledModelGenerateDebugSymbols>True</EfCoreCompiledModelGenerateDebugSymbols>
     <EfCoreCompiledModelVerboseLogging>True</EfCoreCompiledModelVerboseLogging>
   </PropertyGroup>
   

3. 显式指定所有实体类型：避免EF自动扫描实体时遗漏，在OnModelCreating中逐个注册实体：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       modelBuilder.Entity<YourEntity1>();
       modelBuilder.Entity<YourEntity2>();
       // 注册所有需要映射的实体类
   }
   

4. 重新生成编译模型：执行以下命令生成最新的编译模型，并确保DbContext正确引用：

   dotnet ef dbcontext optimize -o Models/CompiledModel
   

   在DbContext配置中指定使用编译模型：

   public class AppDbContext : DbContext
   {
       protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
       {
           optionsBuilder.UseSqlite("Data Source=app.db", b => b.UseCompiledModel(CompiledModel.Instance));
       }
   }
   

方案二：使用预构建模型替代编译模型（兼容EF 8及以下） #

预构建模型在编译阶段生成，无需运行时构建，同样支持AOT：

1. 生成模型快照：创建临时控制台项目，引用你的实体和DbContext，执行以下代码生成模型二进制文件：

   var options = new DbContextOptionsBuilder<AppDbContext>()
       .UseSqlite("Data Source=:memory:")
       .Options;
   using var context = new AppDbContext(options);
   var model = context.Model;
   using var stream = new FileStream("ModelSnapshot.bin", FileMode.Create);
   model.Save(stream);
   

2. 嵌入模型文件：将生成的ModelSnapshot.bin添加到MAUI项目中，设置文件属性为嵌入的资源。
3. 加载预构建模型：在MAUI项目的DbContext中加载嵌入的模型：

   protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
   {
       var assembly = Assembly.GetExecutingAssembly();
       using var stream = assembly.GetManifestResourceStream("YourAppNamespace.ModelSnapshot.bin");
       var prebuiltModel = DbModelLoader.Load(stream);
       optionsBuilder.UseSqlite("Data Source=app.db", b => b.UseModel(prebuiltModel));
   }
   

   注意：实体或映射规则变更后，需重新生成模型快照。

方案三：部分禁用EF相关程序集的AOT编译（折中方案） #

通过调整iOS编译参数，让EF核心程序集跳过AOT编译，既保留大部分代码的AOT性能，又避免模型构建报错：
在MAUI项目文件的iOS专属PropertyGroup中添加：

<PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-ios'">
  <MtouchExtraArgs>--linkskip System.Linq.Expressions --linkskip Microsoft.EntityFrameworkCore</MtouchExtraArgs>
</PropertyGroup>

验证步骤 #

每次修改配置后，执行以下命令清理并重新编译Release版本：

dotnet clean
dotnet build -c Release -f net8.0-ios

在iOS真机或模拟器上运行，验证数据库操作是否正常执行。

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