Maui中调用SetHasBackButton会禁用iOS侧滑返回，是否为预期行为？

结论 #

这是MAUI的有意设计改动，并非bug。

原因说明 #

在Xamarin.Forms中，调用NavigationPage.SetHasBackButton(this, false)仅会隐藏导航栏上的系统返回按钮，iOS的侧滑返回手势（InteractivePopGestureRecognizer）不受影响。但MAUI为了统一跨平台导航行为逻辑，在iOS平台上设置SetHasBackButton为false时，会同时禁用侧滑返回手势，避免出现“按钮隐藏但仍可侧滑返回”这种跨平台行为不一致的情况。

解决方案：隐藏系统返回按钮但保留iOS侧滑返回 #

如果需要在MAUI中实现隐藏系统返回按钮、自定义返回按钮且保留iOS侧滑功能，可以通过以下几种平台特定的方式实现：

方式1：在页面生命周期中手动启用侧滑手势 #

在页面构造函数或HandlerChanged事件中，针对iOS平台重新启用侧滑手势：

public CustomBackButtonPage()
{
    InitializeComponent();
    // 隐藏系统返回按钮
    NavigationPage.SetHasBackButton(this, false);

    // 监听Handler初始化完成事件，确保能获取到iOS原生控制器
    HandlerChanged += OnHandlerChanged;
}

private void OnHandlerChanged(object sender, EventArgs e)
{
#if IOS
    if (Handler?.PlatformView is UIViewController currentController)
    {
        // 重新启用侧滑返回手势
        currentController.NavigationController.InteractivePopGestureRecognizer.Enabled = true;
    }
#endif
}

方式2：通过自定义Handler全局配置 #

如果多个页面需要此行为，可以全局修改NavigationViewHandler的映射逻辑，确保隐藏返回按钮时仍保留侧滑：

// 在Program.cs或App.xaml.cs中注册全局Handler配置
#if IOS
Microsoft.Maui.Handlers.NavigationViewHandler.Mapper.AppendToMapping("PreserveSwipeWhenHidingBackButton", (handler, view) =>
{
    if (handler.PlatformView?.NavigationBar != null && handler.PlatformView.NavigationController != null)
    {
        // 确保侧滑手势始终启用
        handler.PlatformView.NavigationController.InteractivePopGestureRecognizer.Enabled = true;
    }
});
#endif

之后在需要隐藏返回按钮的页面，直接调用NavigationPage.SetHasBackButton(this, false)即可，侧滑功能会被保留。

方式3：直接隐藏iOS导航栏的返回按钮视图 #

不使用SetHasBackButton，而是针对iOS平台直接隐藏导航栏上的返回按钮控件：

protected override void OnAppearing()
{
    base.OnAppearing();
#if IOS
    if (Navigation?.NavigationBar != null)
    {
        // 遍历导航栏子视图，找到返回按钮并隐藏
        foreach (var subView in Navigation.NavigationBar.Subviews)
        {
            if (subView is UIButton backButton)
            {
                backButton.Hidden = true;
            }
        }
        // 清空返回按钮标题避免留白
        Navigation.NavigationBar.BackButtonTitle = string.Empty;
    }
#endif
}

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