Xamarin.Forms iOS平台Image手势识别器引发空引用异常求助

你遇到的这个情况确实是Xamarin.Forms iOS平台在ListView的ViewCell中处理Image手势识别器时的一个已知Bug，并非你的操作有误。

问题原因 #

从异常堆栈指向Xamarin.Forms.Platform.iOS.EventTracker.LoadRecognizers()来看，问题出在iOS渲染层的手势识别处理逻辑上：ListView的ViewCell采用复用机制，iOS端在复用单元格时，Xamarin.Forms默认的EventTracker在绑定Image的手势识别器时，存在内部对象未正确初始化就被访问的情况，从而抛出空引用异常。而Label能正常工作，是因为Label的iOS渲染逻辑与Image不同，没有触发这个疏漏点；ListView外的Image不受单元格复用机制影响，所以也能正常运行。

有效解决方法 #

方案一：自定义Image iOS渲染器（最彻底的全局修复）

创建一个自定义渲染器，手动处理Image的手势识别逻辑，绕过Xamarin.Forms默认的EventTracker问题：

[assembly: ExportRenderer(typeof(Image), typeof(FixedGestureImageRenderer))]
namespace YourAppName.iOS.Renderers
{
    public class FixedGestureImageRenderer : ImageRenderer
    {
        protected override void OnElementChanged(ElementChangedEventArgs<Image> e)
        {
            base.OnElementChanged(e);

            if (Control != null && e.NewElement != null)
            {
                // 清除默认手势，避免冲突
                foreach (var recognizer in Control.GestureRecognizers.ToList())
                {
                    Control.RemoveGestureRecognizer(recognizer);
                }

                // 手动添加Tap手势识别器
                var tapGesture = e.NewElement.GestureRecognizers.OfType<TapGestureRecognizer>().FirstOrDefault();
                if (tapGesture != null)
                {
                    var iosTap = new UITapGestureRecognizer(() =>
                    {
                        // 触发Command（如果设置了的话）
                        tapGesture.Command?.Execute(tapGesture.CommandParameter);
                        // 触发Tapped事件
                        tapGesture.Tapped?.Invoke(e.NewElement, EventArgs.Empty);
                    });
                    iosTap.NumberOfTapsRequired = tapGesture.NumberOfTapsRequired;
                    Control.AddGestureRecognizer(iosTap);
                }
            }
        }
    }
}

方案二：用ContentView包裹Image（快速修复，无需写渲染器）

用ContentView包裹Image，并设置InputTransparent="False"，同时给ViewCell开启HasUnevenRows="True"，这样既可以让Image的手势正常触发，又不会触发ViewCell的点击事件：

<ViewCell HasUnevenRows="True">
    <Grid>
        <!-- 其他布局元素 -->
        <ContentView Grid.Column="1" InputTransparent="False">
            <Image Source="download_cloud.png" WidthRequest="32" HeightRequest="32">
                <Image.GestureRecognizers>
                    <TapGestureRecognizer NumberOfTapsRequired="1" Tapped="SynchronizeItem_Clicked"/>
                </Image.GestureRecognizers>
            </Image>
        </ContentView>
    </Grid>
</ViewCell>

方案三：改用Command绑定（符合MVVM架构的修复）

将手势的事件绑定改为Command绑定，有时候能绕过EventTracker的问题：

<Image Grid.Column="1" Source="download_cloud.png" WidthRequest="32" HeightRequest="32">
    <Image.GestureRecognizers>
        <TapGestureRecognizer NumberOfTapsRequired="1" Command="{Binding SynchronizeCommand}" CommandParameter="{Binding .}"/>
    </Image.GestureRecognizers>
</Image>

然后在你的ViewCell对应的ViewModel中添加命令逻辑：

public ICommand SynchronizeCommand { get; }

public YourItemViewModel()
{
    SynchronizeCommand = new Command(ExecuteSynchronize);
}

private void ExecuteSynchronize(object parameter)
{
    // 这里写原来SynchronizeItem_Clicked方法中的逻辑
}

以上三个方案都能有效解决iOS端的空引用问题，你可以根据项目的架构和需求选择合适的方案。

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