Xamarin.Android 中 AOT 编译导致依赖程序集 GUID 不匹配问题解析

问题现象

在 Xamarin.Android 项目中，当开发者尝试构建 Release 版本应用时，应用在启动闪屏后立即崩溃。错误日志显示一个关键问题：依赖程序集 Microsoft.EntityFrameworkCore.SqlServer 的 GUID 不匹配。具体错误信息表明，预期的 GUID 与实际加载的 GUID 不一致。

问题根源

此问题主要与 Android 平台上的 AOT (Ahead-Of-Time) 编译机制有关。当启用以下构建配置时容易出现此问题：

• RunAOTCompilation 设置为 true
• AndroidStripILAfterAOT 设置为 true
• PublishTrimmed 设置为 true

问题的本质在于，当启用 AndroidStripILAfterAOT 选项时，构建系统会在 AOT 编译后剥离 IL 代码，这可能导致依赖程序集的元数据不一致，特别是当存在多个版本的程序集或构建缓存未正确清理时。

解决方案

经过技术团队的分析，推荐以下解决方案：

1. 清理构建缓存：执行完整的清理操作，包括删除 bin 和 obj 文件夹，或使用全新的代码检出。这可以确保构建过程从干净状态开始。

2. 谨慎使用实验性功能：AndroidStripILAfterAOT 目前仍被视为实验性功能，在 .NET 10 中可能会被移除。对于生产环境应用，建议避免使用此选项。

3. 优化构建配置：可以考虑以下替代配置方案：

   • 保持 RunAOTCompilation 启用以获得性能优势
   • 禁用 AndroidStripILAfterAOT 以避免潜在问题
   • 根据实际需求评估 PublishTrimmed 的必要性

技术背景

AOT 编译是 .NET 在移动平台上的重要优化手段，它将 IL 代码预先编译为原生代码，提高应用启动速度和运行时性能。然而，当与程序集裁剪和 IL 剥离结合使用时，可能会遇到元数据一致性问题。

GUID 不匹配错误通常表明运行时加载的程序集版本与编译时引用的版本不一致。在 Android 环境下，这个问题可能因构建缓存或实验性优化选项而加剧。

最佳实践建议

1. 对于关键生产应用，建议采用更稳定的构建配置组合
2. 在升级 Xamarin.Android 版本后，始终执行完整清理构建
3. 密切关注实验性功能的官方文档更新
4. 考虑使用更现代的 .NET MAUI 框架，其中部分构建问题已得到改进

通过理解这些底层机制和采取适当的预防措施，开发者可以避免类似问题，确保应用在 Release 模式下的稳定运行。