Xamarin Forms iOS真机Release模式SQLite-Net-pcl触发JIT错误求助

问题背景 #

Xamarin Forms应用本地SQLite数据库存储多个自定义类，UWP、Android、iOS模拟器调试环境运行正常，iOS物理设备Release模式持续触发JIT告警，调整链接器配置无效果，初步怀疑与SQLite-Net-pcl NuGet库相关。

相关代码 #

public abstract class SqlRepositoryLite<T, TInterface> : IRepositoryLite<TInterface> where T : class, IDto, TInterface, new()
{
    public IEnumerable<TInterface> Items => Connection.Table<T>();
}

崩溃日志 #

SIGABRT: Attempting to JIT compile method '(wrapper delegate-invoke) void <Module>:invoke_callvirt_void_CharacterItem_int (PFAssistant.Core.Services.CharacterItem,int)' while running in aot-only mode.

堆栈跟踪 #

FastColumnSetter+<>c__DisplayClass2_0`2[ObjectType,ColumnMemberType].<CreateTypedSetterDelegate>b__0 (System.Object o, SQLitePCL.sqlite3_stmt stmt, System.Int32 i)
SQLiteCommand+<ExecuteDeferredQuery>d__12`1[T].MoveNext ()
List`1[T].AddEnumerable (System.Collections.Generic.IEnumerable`1[T] enumerable)
System.Collections.Generic.List`1[T]..ctor (System.Collections.Generic.IEnumerable`1[T] collection) <0x1052cce30 + 0x0021f> in <25bf495f7d6b4944aa395b3ab5293479#0dcf7231fb8229d159bd9a1419156fe3>:0
Enumerable.ToList[TSource] (System.Collections.Generic.IEnumerable`1[T] source)
SQLiteCommand.ExecuteQuery[T] ()

根因分析 #

抽象类层级过高不是导致该问题的原因。故障根因为SQLite-Net-pcl特定版本内部FastColumnSetter逻辑通过运行时动态生成委托完成数据库列到实体的赋值，该动态生成的调用逻辑无法被AOT编译器提前编译，而iOS物理设备Release模式禁止JIT编译，因此触发崩溃。

解决方案 #

• 优先锁定SQLite-Net-pcl版本：经实测v1.7.335版本不存在该缺陷，直接将NuGet包版本固定为v1.7.335即可解决问题，v1.6.292、v1.8.116版本均存在相同AOT适配问题，避免使用。
• 给所有SQLite存储实体添加Preserve属性：在实体类上标记[Preserve(AllMembers = true)]，防止链接器裁剪实体类的属性、构造函数等成员，避免间接触发动态委托生成异常。
• 调整iOS编译配置：Release模式下将链接器行为设置为「仅链接SDK程序集」，同时勾选「启用增量AOT编译」，避免非必要的代码裁剪和编译优化。
• 高版本适配方案：如果必须使用高版本SQLite-Net-pcl，可自行修改源码替换FastColumnSetter的动态委托生成逻辑，改用预编译表达式树或者反射赋值完成列到实体的映射，确保所有调用逻辑均可被AOT编译器提前识别。

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