MAUI iOS端UICollectionViewFlowLayout布局异常报错求助

方案1：自定义iOS平台CollectionView处理器 #

这类报错多是MAUI默认布局计算Border+Image组合控件尺寸时的精度问题，直接重写iOS端布局逻辑：

在项目的Platforms/iOS目录下添加代码：

using UIKit;
using Microsoft.Maui.Handlers;

namespace YourAppNamespace.Platforms.iOS;

public class FixedCollectionViewHandler : CollectionViewHandler
{
    protected override UICollectionView CreatePlatformView()
    {
        var layout = new UICollectionViewFlowLayout();
        // 禁用自动尺寸估算，避免触发布局警告
        layout.EstimatedItemSize = CGSize.Empty;
        var collectionView = new UICollectionView(CGRect.Empty, layout);
        return collectionView;
    }
}

然后在MauiProgram.cs中注册自定义处理器：

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler<CollectionView, YourAppNamespace.Platforms.iOS.FixedCollectionViewHandler>();
#endif
});

方案2：替换Border控件 #

Border在iOS端的渲染层级可能导致布局计算歧义，改用Frame或直接给Image添加边框样式：

替换为Frame： #

<CollectionView ItemsSource="{Binding Items}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Frame CornerRadius="8" BorderColor="Gray" Padding="0">
                <Image Source="{Binding ImageSource}"
                       Aspect="AspectFill"
                       HeightRequest="100"
                       WidthRequest="100"/>
            </Frame>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

直接给Image加边框： #

<CollectionView ItemsSource="{Binding Items}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Image Source="{Binding ImageSource}"
                   Aspect="AspectFill"
                   HeightRequest="100"
                   WidthRequest="100"
                   BorderColor="Gray"
                   BorderWidth="1"
                   CornerRadius="8"/>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

方案3：强制指定Item固定尺寸 #

明确设置CollectionView的ItemSize，消除自动计算的不确定性：

<CollectionView ItemsSource="{Binding Items}">
    <CollectionView.ItemsLayout>
        <GridItemsLayout Span="2"
                         ItemWidth="150"
                         ItemHeight="150"/>
    </CollectionView.ItemsLayout>
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Border CornerRadius="8"
                    BorderBrush="Gray"
                    Padding="0">
                <Image Source="{Binding ImageSource}"
                       Aspect="AspectFill"
                       HeightRequest="148"
                       WidthRequest="148"/>
            </Border>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

注意ItemSize需预留出Border的宽度，避免布局溢出。

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