Xamarin Forms中Hybrid WebView的Navigating与Navigated事件无响应如何解决

核心根因 #

90%以上的该类问题都是自定义HybridWebView的实现存在缺陷，没有把底层加载逻辑关联到Xamarin.Forms层的导航事件链路。

排查步骤 #

• 确认HybridWebView是否直接继承自Xamarin.Forms原生WebView：如果使用了自定义渲染器重写了平台加载逻辑，必须手动转发原生控件的导航事件到Forms层
• 检查自定义Uri属性的实现：如果是自行声明的Uri依赖属性，确认属性变更回调中触发了WebView的加载逻辑
• 验证绑定有效性：确认绑定的Source属性有有效值，且触发了PropertyChanged通知，HybridWebView内部确实收到了加载请求
• 临时替换验证：把XAML中的local:HybridWebView换成原生WebView测试，如果事件可以正常触发，即可确认是自定义控件的逻辑缺陷

修复方案 #

1. 修复自定义Uri属性逻辑 #

如果自行实现了Uri依赖属性，确保属性变更时触发基类加载逻辑：

// HybridWebView的Uri依赖属性正确实现示例
public static readonly BindableProperty UriProperty = BindableProperty.Create(
    nameof(Uri), typeof(string), typeof(HybridWebView), propertyChanged: OnUriChanged);

public string Uri
{
    get => (string)GetValue(UriProperty);
    set => SetValue(UriProperty, value);
}

private static void OnUriChanged(BindableObject bindable, object oldValue, object newValue)
{
    if (newValue is string uri && !string.IsNullOrEmpty(uri))
    {
        var webView = (HybridWebView)bindable;
        // 调用基类Source赋值触发默认加载流程，才会走默认事件链路
        webView.Source = new UrlWebViewSource { Url = uri };
    }
}

2. 自定义渲染器补充事件转发 #

如果用了平台自定义渲染器，需要手动把原生Web控件的导航事件转发到Forms层，以Android为例：

// Android平台自定义渲染器示例
protected override void OnElementChanged(ElementChangedEventArgs<Xamarin.Forms.WebView> e)
{
    base.OnElementChanged(e);
    if (Control == null || e.NewElement == null) return;
    Control.SetWebViewClient(new CustomWebViewClient(this));
}

// 自定义WebViewClient转发事件
internal class CustomWebViewClient : WebViewClient
{
    private readonly HybridWebViewRenderer _renderer;
    public CustomWebViewClient(HybridWebViewRenderer renderer)
    {
        _renderer = renderer;
    }

    public override void OnPageStarted(Android.Webkit.WebView view, string url, Bitmap favicon)
    {
        // 手动触发Forms层Navigating事件
        var args = new WebNavigatingEventArgs(WebNavigationEvent.NewPage, new Uri(url), null);
        _renderer.Element.SendNavigating(args);
        base.OnPageStarted(view, url, favicon);
    }

    public override void OnPageFinished(Android.Webkit.WebView view, string url)
    {
        // 手动触发Forms层Navigated成功事件
        var args = new WebNavigatedEventArgs(WebNavigationEvent.NewPage, new Uri(url), null, WebNavigationResult.Success);
        _renderer.Element.SendNavigated(args);
        base.OnPageFinished(view, url);
    }

    public override void OnReceivedError(Android.Webkit.WebView view, IWebResourceRequest request, WebResourceError error)
    {
        // 手动触发Forms层Navigated失败事件
        var args = new WebNavigatedEventArgs(WebNavigationEvent.NewPage, new Uri(request.Url.ToString()), null, WebNavigationResult.Failure);
        _renderer.Element.SendNavigated(args);
        base.OnReceivedError(view, request, error);
    }
}

iOS实现逻辑同理，在原生WKNavigationDelegate的对应回调中调用SendNavigating/SendNavigated方法转发事件即可。

3. 调整加载时机避免事件漏触发 #

如果是首次加载无响应，可把Uri赋值延后到页面OnAppearing执行之后，确保事件订阅完成再触发加载：

protected override void OnAppearing()
{
    base.OnAppearing();
    // 确认事件绑定完成后再赋值触发加载
    hybridWebView.Uri = ViewModel.Source;
}

注意事项 #

• 如果在Navigating事件中设置了e.Cancel = true，后续Navigated事件不会触发
• 使用LoadHtmlString加载本地静态内容时，默认不会触发导航事件，需要调用加载方法后手动触发对应事件

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