.NET MAUI生产环境启动抛InvalidCastException问题求助

1. 排查发布模式XAML编译的类型转换问题 #

• 发布模式采用AOT编译，DEBUG模式为JIT，后者允许的隐式类型转换在AOT下会触发严格检查。重点查看OnboardingItemView.xaml中所有绑定、SizeAdapter标记扩展的使用场景，比如是否存在字符串转数值、不同数值类型（int/double）混用的情况——闪屏页可能刚好类型匹配，而该视图存在疏漏。
• 检查InitializeComponent对应的XAML代码，确认所有属性赋值的类型与目标属性严格匹配，比如HeightRequest要求double类型，就不能让SizeAdapter返回int。

2. 验证自定义SizeAdapter在发布模式的行为差异 #

• 尽管闪屏页可用，但OnboardingItemView的使用场景（如绑定上下文、调用时机）可能不同。检查SizeAdapter的ProvideValue方法：
  • 确保返回值类型完全符合目标属性要求，避免依赖JIT的隐式转换；
  • 若方法内有反射逻辑，发布模式下链接器可能移除相关类型，需用[Preserve]标记或在Linker.xml中添加保留规则。

3. 确认ViewModel注入的类型匹配性 #

• 即使已注册ViewModel，发布模式下链接器优化可能导致类型匹配失效。检查OnboardingItemView构造函数的注入参数，确认注册的接口/类型与参数类型完全一致，比如注册IOnboardingViewModel就不能让构造函数接收具体实现类，避免AOT下类型转换失败。

4. 开启发布模式的详细调试日志 #

• Android：在项目属性的发布配置中勾选"Debug symbols"，用adb logcat捕获启动时的完整异常信息，明确InvalidCastException的源类型和目标类型；
• iOS：通过Xcode连接设备，查看控制台日志，获取更具体的转换失败细节，比单纯堆栈跟踪更有价值。

5. 排查链接器优化的误删问题 #

• 发布模式下链接器会移除未被显式引用的代码，可能导致XAML关联的类型被误删。临时将发布配置的链接行为设为"None"，若应用恢复正常，说明是链接器问题，再用[Preserve]标记OnboardingItemView、ViewModel、SizeAdapter等相关类型，强制链接器保留。

6. 检查XAML的命名空间与类型引用 #

• 确认OnboardingItemView.xaml中自定义控件、标记扩展的命名空间引用正确，发布模式下XAML编译对拼写、大小写的容错性更低，避免因命名空间错误导致类型识别异常。

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