MAUI应用GetDesiredSizeFromHandler中virtualView.Height为NaN问题求助

问题概况 #

运行MAUI应用时触发异常，报错点在Microsoft.Maui.ViewHandlerExtensions.GetDesiredSizeFromHandler方法，核心问题是virtualView.Height的值为NaN。报错文件是运行时自动生成的临时文件（路径C:\Users\rober\AppData\Local\SourceServer\f44e4109387c12ac95457c136b1a9d98770c4d8a0d4e46d8292e17ac198b041e\ViewHandlerExtensions.Android.cs），无法直接修改。

此前连接常规Android设备调试完全正常，连接Galaxy Fold后首次出现该问题；更换Galaxy 9设备后，运行3-4次也触发相同报错。

报错相关代码片段 #

// Create a spec to handle the native measure
var widthSpec = Context.CreateMeasureSpec(widthConstraint, virtualView.Width, virtualView.MaximumWidth);
var heightSpec = Context.CreateMeasureSpec(heightConstraint, virtualView.Height, virtualView.MaximumHeight);

platformView.Measure(widthSpec, heightSpec);

调用栈片段 #

0xFFFFFFFFFFFFFFFF in Android.Runtime.JNIEnv.monodroid_debugger_unhandled_exception C#
0x1A in Android.Runtime.JNINativeWrapper._unhandled_exception at /Users/runner/work/1/s/xamarin-android/src/Mono.Android/Android.Runtime/JNINativeWrapper.g.cs:12,5 C#
0x1F in Android.Runtime.JNINativeWrapper.Wrap_JniMarshal_PPI_L at /Users/runner/work/1/s/xamarin-android/src/Mono.Android/Android.Runtime/JNINativeWrapper.g.cs:67,26   C#
0xB in System.ThrowHelper.ThrowArgumentNullException    C#
...（完整调用栈见原文）

问题排查方向 #

• 布局约束冲突：折叠屏或部分设备的特殊屏幕尺寸/密度，导致布局计算时生成非法数值（NaN）
• 视图初始化不完整：部分控件在渲染前未完成尺寸绑定，Height属性未被正确赋值
• MAUI框架适配bug：特定Android设备与MAUI的视图测量逻辑存在兼容性问题

可行修复方案 #

1. 排查并修正布局中的动态尺寸设置 #

• 检查XAML中所有使用HeightRequest或绑定Height属性的控件，确保绑定数据源不会返回NaN或无效数值
• 避免直接将Height设为double.NaN，改用HeightRequest或依赖布局容器（如Grid、StackLayout）的约束自动计算尺寸

2. 强制初始化视图默认尺寸 #

在问题视图所在页面/控件的OnAppearing或HandlerChanged事件中，手动设置合理默认值：

protected override void OnAppearing()
{
    base.OnAppearing();
    if (MyTargetView.Height.IsNaN())
    {
        MyTargetView.HeightRequest = 400; // 根据实际场景调整数值
    }
}

3. 清理缓存并重建项目 #

• 右键项目选择「清理」，删除bin、obj目录
• 卸载设备上的应用，清除设备端缓存
• 重启Visual Studio和调试设备后重新部署

4. 针对折叠屏的特殊适配（若问题源于折叠设备） #

添加屏幕尺寸监听逻辑，动态调整视图尺寸：

#if ANDROID
using Android.Content.Res;

private void AdjustViewSizeForScreen()
{
    var metrics = Resources.DisplayMetrics;
    if (metrics.HeightPixels <= 0) return;
    // 根据屏幕高度比例设置视图尺寸
    MyTargetView.HeightRequest = metrics.HeightPixels * 0.6;
}
#endif

5. 升级MAUI SDK版本 #

检查并更新到最新的.NET MAUI SDK，官方可能已修复此类设备适配问题

内容的提问来源于stack exchange，提问作者Robert Green MBA