.NET MAUI应用Release模式下EF Core SQLite查询崩溃求助

问题概述 #

• 环境：.NET MAUI应用，基于Entity Framework Core 8.0.8 + SQLite实现数据库访问
• 现象：iOS 17.6升级前，Release模式部署到iPhone 14 Pro Max可正常运行；升级后，Release模式下仅获取DbSet对象无崩溃，但执行ToList()/ToListAsync()等查询操作时应用直接崩溃，且无法进入catch块捕获异常；iOS 17.5模拟器的Debug模式可正常执行数据库查询。
• 已尝试操作：调整编译配置（UseInterpreter、MtouchUseLlvm、RunAOTCompilation等参数）无效；将应用复制后修改名称、命名空间、ApplicationId等信息，部署到iPhone可正常运行，但仅修改原应用的ApplicationId仍崩溃。

排查方向 #

1. iOS 17.6的AOT编译兼容性冲突 #

EF Core在AOT编译场景下依赖静态代码分析，iOS 17.6可能调整了AOT编译规则，原应用的编译缓存或生成的AOT代码残留了旧的兼容逻辑，而新复制的应用重建了编译上下文，规避了该问题。

• 重点检查EF Core的AOT适配情况：确认是否为DbContext和所有实体类型添加了显式配置（避免依赖反射自动发现实体）；排查是否使用了EF Core不支持AOT的API（如Include中的复杂Lambda表达式、动态查询等）。

2. 应用沙盒的数据库文件权限或缓存异常 #

iOS 17.6可能更新了沙盒内文件访问的权限机制，原应用的数据库文件或缓存数据存在权限异常，新复制的应用使用全新沙盒目录，无历史缓存干扰。

• 验证数据库文件路径合法性：确保使用FileSystem.AppDataDirectory获取沙盒内的合法存储路径，避免硬编码路径；尝试卸载原应用、清除设备缓存后重新部署Release版本测试。

3. 代码签名与Provisioning Profile残留问题 #

仅修改原应用的ApplicationId仍崩溃，可能原应用的签名配置、Provisioning Profile存在与iOS 17.6不兼容的残留信息，新复制的应用重新生成了签名相关文件，未受旧配置影响。

• 清理项目签名缓存：删除obj、bin目录，以及Visual Studio的iOS编译缓存（~/Library/Caches/Xamarin/mtbs/builds）；检查Provisioning Profile是否为适配iOS 17.6的最新版本，确认Bundle ID与ApplicationId完全匹配。

4. EF Core SQLite驱动的版本兼容性 #

iOS 17.6可能更新了系统内置SQLite库版本，EF Core 8.0.8的SQLite驱动存在兼容性问题。

• 尝试升级EF Core到8.x系列的最新补丁版本，或切换为使用嵌入的SQLite库（通过Microsoft.Data.Sqlite.Core配合SQLPCLRaw.core等NuGet包）。

解决方案 #

方案1：彻底清理编译缓存并重建 #

1. 删除项目根目录下的obj、bin文件夹，以及iOS平台专属的obj/Release/net8.0-ios子目录；
2. 清除Visual Studio的iOS编译缓存：删除~/Library/Caches/Xamarin/mtbs/builds路径下与当前项目相关的文件夹；
3. 重新生成解决方案，选择Release模式重新部署到iPhone设备。

方案2：配置EF Core为AOT兼容模式 #

1. 在DbContext的OnModelCreating方法中添加所有实体的显式配置，避免依赖反射：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 示例：显式配置实体表名与属性
    modelBuilder.Entity<Product>()
        .ToTable("Products")
        .HasKey(p => p.Id);
    modelBuilder.Entity<Product>()
        .Property(p => p.Name)
        .IsRequired()
        .HasMaxLength(100);
    // 为所有实体添加类似配置
}

2. 在项目的.csproj文件中添加AOT兼容配置：

<PropertyGroup>
  <PublishTrimmed>true</PublishTrimmed>
  <TrimMode>partial</TrimMode>
  <AotCompilation>true</AotCompilation>
  <!-- 禁用EF Core动态代码生成，强制AOT兼容 -->
  <EFCoreEnableDynamicCodeGeneration>false</EFCoreEnableDynamicCodeGeneration>
</PropertyGroup>

方案3：重置应用沙盒与权限 #

1. 卸载iPhone上的原应用，重启设备；
2. 重新部署Release版本应用，首次启动时确认所有权限请求（如文件访问）均已允许；
3. 若使用EF Core迁移，确保首次启动时执行数据库初始化逻辑（删除旧数据库文件，重新创建并执行迁移）。

方案4：重新配置代码签名 #

1. 删除项目中的Entitlements.plist文件，重新生成新的权限配置文件；
2. 登录Apple Developer Portal，重新创建适配iOS 17.6的Provisioning Profile，下载后导入到Visual Studio；
3. 确认项目的ApplicationId与Provisioning Profile中的Bundle ID完全一致（注意大小写和特殊字符）。

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