.NET Android 项目中 CoreCLR 启动崩溃问题分析与解决方案

问题背景

在 .NET 10.0.100-preview.3 版本中，使用 dotnet new maui -sc 命令创建的 MAUI 项目在 Android 平台上运行时出现了 CoreCLR 启动崩溃的问题。这个问题主要涉及两个技术层面的故障：

1. 在 Activity 生命周期回调中 WeakReference 初始化失败
2. 托管封送方法查找表中的 IL 指令越界

核心问题分析

WeakReference 初始化失败

当 MAUI 的 ActivityLifecycleContextListener.onActivityResumed 方法在启动时被调用时，系统尝试设置 WeakReference 的 Target 属性时抛出了 InvalidOperation_HandleIsNotInitialized 异常。深入分析发现：

1. 在 CoreCLR 环境下，Android 运行时仍然使用 AndroidValueManager 来管理 Java 对象引用
2. AndroidValueManager 使用 WeakReference 来保存引用，这导致没有任何强引用保持对象存活
3. 当 Java 端持有对 Activity 的唯一强引用时，.NET 端的弱引用无法正确维持对象生命周期

IL 指令越界问题

在托管封送方法查找表的实现中，当类中包含大量 UCO (User Code Only) 方法时，编译器生成的 switch 语句 IL 代码中使用了 br.s 指令。这个指令的跳转偏移量限制为 8 位有符号整数（-128 到 127），当跳转距离超过这个范围时就会导致无效的 IL 代码。

解决方案

针对 WeakReference 问题的修复

1. 在 CoreCLR 环境下改用类似 NativeAOTValueManager 的引用管理策略
2. 使用强引用而非弱引用来保持 IJavaPeerable 实例
3. 虽然这会暂时增加内存占用（对象不会被回收），但确保了对象在 Java 端持有引用时的正确性

针对 IL 指令问题的修复

1. 重新设计托管封送方法查找表的代码生成逻辑
2. 避免生成过大的 switch 语句块
3. 将大型 switch 语句拆分为多个小型 switch 语句
4. 确保 br.s 指令的跳转偏移量在有效范围内

技术影响与启示

这个问题的解决过程为我们提供了几个重要的技术启示：

1. 运行时环境适配：不同 .NET 运行时（CoreCLR、Mono、NativeAOT）需要针对性地处理对象生命周期管理
2. IL 代码生成限制：编译器后端需要充分考虑目标平台的 IL 指令限制
3. 跨语言交互：Java 和 .NET 之间的互操作需要特别注意引用管理策略
4. 渐进式改进：在完整解决方案（如 GC Bridge）可用前，采用临时但稳定的解决方案

验证结果

通过上述修复后，在 .NET 10.0.100-preview.3 版本中验证确认：

1. dotnet new maui -sc 模板项目能够正常启动
2. CoreCLR 运行时环境下不再出现启动崩溃
3. 托管封送方法查找功能正常工作

这个问题展示了 .NET 多平台开发中运行时适配的重要性，也为未来类似问题的解决提供了参考模式。开发者在处理跨平台、跨运行时的问题时，需要特别注意不同环境下的行为差异和限制条件。