Xamarin.iOS 16.0抛出System.ArgumentException：NaN不是有效的width值

问题背景 #

环境：Visual Studio 2022(17.3.6)、Xamarin 17.3.0.308、Xamarin.iOS和Xamarin.Mac SDK 16.0.0.75，点击包含自定义ItemTemplate的ListView所在页面时应用崩溃，在UIApplication.Main处抛出System.ArgumentException，提示NaN is not a valid value for width，已尝试更新相关版本但问题未解决。

排查与解决方案 #

• 检查自定义ItemTemplate的宽度绑定
  重点排查ItemTemplate内控件的WidthRequest、ColumnDefinition等尺寸属性：

  • 确认是否绑定了未初始化、可能为null或计算后为NaN的属性（比如存在除以0的计算逻辑）；
  • 给动态绑定的尺寸属性添加默认值，例如WidthRequest="{Binding ItemWidth, FallbackValue=120}"，避免空值/NaN传入。

• 修正ListView及父布局的约束

  • 避免ListView的HorizontalOptions设为FillAndExpand但父容器宽度不确定的情况，可尝试给ListView设置明确的WidthRequest，或确保父布局（如Grid）的列宽是确定值/星号比例；
  • 检查是否存在布局循环依赖（比如控件宽度依赖父容器，父容器宽度又依赖该控件），调整布局结构消除循环。

• 校验数据源的数值属性

  • 检查ListView绑定的ItemsSource中，所有关联到尺寸计算的数据项属性是否正确初始化，确保没有默认值为NaN的情况；
  • 若有动态计算尺寸的逻辑，添加防NaN判断，示例：

    public double CalculatedWidth
    {
        get
        {
            // 避免除数为0导致NaN
            return Divisor == 0 ? 100 : TotalWidth / Divisor;
        }
    }
    

• 定位具体出错控件

  • 在自定义ViewCell的OnAppearing事件或绑定完成事件中，打印控件的宽度值，通过日志定位哪个控件出现了NaN宽度：

    protected override void OnAppearing()
    {
        base.OnAppearing();
        Debug.WriteLine($"Label Width: {MyLabel.WidthRequest}");
        Debug.WriteLine($"Grid Column Width: {MyGrid.ColumnDefinitions[0].Width}");
    }
    

• 简化布局逐步复现
  先将ItemTemplate替换为最简布局（如仅一个Label），确认是否还崩溃。若正常，再逐步添加原布局的控件和约束，快速定位到触发问题的具体元素。

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