.NET MAUI iOS常规页面导航下侧滑返回功能失效问题

问题背景 #

用NavigationPage做导航（未使用Shell），原本预期iOS侧滑返回功能默认生效，但在Page2设置NavigationPage.HasNavigationBar="False"后，侧滑返回完全失效——就算在OnAppearing里手动开启InteractivePopGestureRecognizer.Enabled也没用。

问题原因 #

iOS的侧滑返回手势默认和导航栏绑定，当隐藏导航栏后，系统默认的手势关联逻辑会被破坏，单独设置Enabled=true无法恢复手势功能，必须重新绑定手势的代理对象。

解决办法 #

替换原来在OnAppearing中的代码，改用OnHandlerChanged方法处理（这个时机能确保平台视图已完全初始化），具体代码如下：

protected override void OnHandlerChanged()
{
    base.OnHandlerChanged();
#if IOS
    if (Handler?.PlatformView is UIKit.UIViewController viewController)
    {
        var navController = viewController.NavigationController;
        if (navController != null)
        {
            navController.InteractivePopGestureRecognizer.Enabled = true;
            // 将手势代理绑定回导航控制器，修复隐藏导航栏后的关联问题
            navController.InteractivePopGestureRecognizer.Delegate = navController;
        }
    }
#endif
}

注意事项 #

• 不要在OnAppearing中处理：此时平台视图可能未完全初始化，会导致获取UINavigationController失败或设置不生效。
• 全局复用方案：如果多个页面需要隐藏导航栏，可创建一个自定义页面基类，将上述代码放在基类的OnHandlerChanged中，所有目标页面继承该基类即可，避免重复编码。

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