迁移Xamarin.iOS至.NET iOS：启用AOT时如何识别不兼容程序集？

以下是几个实用的技术手段，帮你定位导致AOT崩溃的程序集：

• 启用AOT详细诊断日志
  在项目的.csproj文件中添加配置：

  <AotDiagnosticVerbosity>Detailed</AotDiagnosticVerbosity>
  

  重新编译Release版本时，编译日志会输出AOT处理每个程序集的细节，包括哪些类型、方法因为AOT不兼容被标记为需要回退到解释器，或者直接抛出警告。重点关注日志中包含AOT warning、cannot be AOT-compiled这类关键词的条目，对应的程序集就是排查重点。

• 逐步排除+验证法
  先通过配置将所有第三方程序集排除在AOT编译外：

  <AotExcludeAssemblies>AssemblyA,AssemblyB,AssemblyC</AotExcludeAssemblies>
  

  确认此时启用AOT后程序能正常运行，再逐个移除排除列表中的程序集，每次编译运行验证是否出现崩溃。一旦移除某个程序集后崩溃重现，该程序集就是不兼容的源头。

• 检查代码中的AOT敏感模式
  针对自己的代码和依赖库，重点排查以下场景：

  • 使用System.Reflection.Emit动态生成方法、程序集（比如DynamicMethod、AssemblyBuilder）
  • 动态反射调用未知类型的构造函数或方法（比如运行时才确定类型参数的Activator.CreateInstance）
  • 依赖动态代理的库（如旧版Castle DynamicProxy）、部分旧的JSON序列化库（依赖JIT生成序列化逻辑）
  • 泛型类型的动态实例化，且类型参数在编译期无法确定

• 分析MSBuild二进制日志
  编译时添加/bl参数生成二进制日志：

  dotnet build -c Release /bl
  

  用MSBuild Structured Log Viewer打开日志文件，定位到AotCompile相关任务，查看每个程序集的处理结果，能更直观地找到AOT处理失败或有警告的程序集。

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