Xamarin.iOS 中 SecRecord 构造函数在裁剪时抛出 InvalidCastException 问题分析

在 Xamarin.iOS 项目中，开发人员在使用 Security 框架的 SecRecord 类创建通用密码记录时，可能会遇到一个棘手的运行时异常。本文将深入分析这个问题的成因、影响范围以及解决方案。

问题现象

当开发人员尝试使用以下代码创建 SecRecord 实例时：

var rec = new Security.SecRecord(Security.SecKind.GenericPassword);

在 .NET 9.0.301.1 和 iOS 18.5.9199 环境下，应用程序会抛出 InvalidCastException 异常，调用栈显示问题发生在 NSMutableDictionary.LowlevelFromObjectAndKey 方法中。

问题背景

这个问题特别出现在启用了代码裁剪(trimming)的构建配置中。代码裁剪是 .NET 的一项优化功能，它会移除应用程序未使用的代码，减小最终程序包的大小。但在某些情况下，过于激进的裁剪可能会导致运行时行为异常。

根本原因

经过分析，这个问题源于 Xamarin.iOS 的运行时类型系统与代码裁剪器之间的交互问题。当启用裁剪时，特别是使用 "full" 或 "partial" 裁剪模式时，裁剪器可能会错误地移除某些必要的类型信息，导致运行时类型转换失败。

具体来说，NSMutableDictionary 在底层需要执行一些类型转换操作来桥接 .NET 类型和 Objective-C 类型。当这些转换所需的元数据被裁剪掉后，就会导致 InvalidCastException。

影响范围

该问题主要影响：

• 使用 Security 框架的 Xamarin.iOS 应用程序
• 启用了代码裁剪的构建配置
• .NET 9.0.301.1 及 iOS 18.5.9199 环境

解决方案

目前有两种可行的解决方案：

临时解决方案

1. 禁用或减少裁剪级别： 在项目文件中调整 TrimMode 设置：

   <TrimMode Condition="'$(Configuration)' == 'Debug'">partial</TrimMode>
   <TrimMode Condition="'$(Configuration)' == 'Release'">full</TrimMode>
   

   或者完全禁用裁剪（不推荐，会增加应用体积）。

2. 使用静态类型注册方式： 在项目文件中添加：

   <PropertyGroup>
       <Registrar>managed-static</Registrar>
   </PropertyGroup>
   

   这种方法会导致构建时间稍长，但可以避免裁剪引发的问题。

长期解决方案

Xamarin.iOS 团队已经确认这是一个回归问题，并正在修复中。修复预计会包含在下一个服务版本中。开发人员可以关注官方更新以获取修复版本。

最佳实践建议

1. 在启用代码裁剪时，务必进行充分的测试，特别是涉及平台特定功能的部分。
2. 考虑为安全相关的代码添加裁剪注解，确保关键类型不会被意外移除。
3. 保持开发环境更新，及时应用修复版本。
4. 在性能敏感的应用中，可以评估静态注册方式的性能影响是否可接受。

总结

代码裁剪是一项强大的优化技术，但在与复杂的平台互操作场景中可能会引发微妙的问题。Xamarin.iOS 团队正在积极解决这个特定的 SecRecord 构造函数问题。在此期间，开发人员可以使用上述解决方案来规避问题，同时保持应用程序的正常功能。