MAUI iOS端QLPreviewController引发NullReferenceException问题求助

数据老陈

2026-8-13

解决MAUI中QLPreviewController/UIDocumentInteractionController触发NullReferenceException的问题

问题分析

该错误源于MAUI兼容性渲染器的SecondaryToolbar在布局时出现空引用，本质是原生iOS控制器与MAUI导航栈的交互逻辑冲突——虽然文件能正常预览，但渲染器的工具栏布局逻辑在后台抛出异常。

解决方法

改用模态方式打开预览控制器
放弃PushViewController，改用模态弹出的方式，避开MAUI导航栏渲染逻辑的冲突：
```
// 替换原Push逻辑为模态呈现
view.PresentViewController(previewController, true, null);
```
针对UIDocumentInteractionController，同样确保用模态方式打开，同时正确设置其Delegate处理回调逻辑。

自定义导航渲染器修复空引用
如果必须使用Push方式，可自定义iOS导航渲染器，提前检查对象是否为空：

using Microsoft.Maui.Controls.Handlers.Compatibility;
using UIKit;

[assembly: ExportRenderer(typeof(NavigationPage), typeof(CustomNavigationRenderer))]
namespace MAUISample.iOS.Renderers;

public class CustomNavigationRenderer : NavigationRenderer
{
    protected override void OnElementChanged(VisualElementChangedEventArgs e)
    {
        base.OnElementChanged(e);
        if (SecondaryToolbar != null)
        {
            SecondaryToolbar.LayoutSubviews -= SecondaryToolbar_LayoutSubviews;
            SecondaryToolbar.LayoutSubviews += SecondaryToolbar_LayoutSubviews;
        }
    }

    private void SecondaryToolbar_LayoutSubviews()
    {
        try
        {
            if (SecondaryToolbar?.Items == null) return;
            base.SecondaryToolbar.LayoutSubviews();
        }
        catch (NullReferenceException)
        {
            // 捕获异常避免程序崩溃
        }
    }
}