.NET MAUI iOS导航栏分隔线隐藏失效问题求助

算力阿峰

2026-7-2

.NET MAUI iOS导航栏分隔线后台恢复后重现的解决办法

问题原因

当应用从后台恢复时，iOS系统可能会触发主题相关的UI重置（即便没手动切换主题），而你在RequestedThemeChanged事件处理器里调用的SetBarColors()会重置导航栏的背景色、文字色等样式，这个过程会覆盖之前通过SetHideNavigationBarSeparator(true)设置的分隔线隐藏配置。哪怕后来在SetBarColors()里加了隐藏代码也无效，是因为MAUI的SetHideNavigationBarSeparator扩展方法在导航栏样式被系统重置后，无法正确覆盖原生iOS控件的默认配置，必须直接操作原生控件才能生效。

解决方案

方案1：在`SetBarColors()`中直接操作iOS原生导航栏控件

修改SetBarColors方法，跳过MAUI扩展方法，直接设置iOS原生UINavigationBar的阴影图为空，确保样式重置后分隔线始终隐藏：

private void SetBarColors()
{
    // 保留原有栏颜色设置逻辑
    var isDarkTheme = Application.Current.RequestedTheme == AppTheme.Dark;
    BarBackgroundColor = isDarkTheme ? Colors.DarkGray : Colors.LightGray;
    BarTextColor = isDarkTheme ? Colors.White : Colors.Black;

    // 直接操作iOS原生控件隐藏分隔线
    if (Handler?.PlatformView is UIKit.UINavigationBar navBar)
    {
        navBar.ShadowImage = UIKit.UIImage.Empty;
        // 设置空背景图避免出现额外导航栏边距
        navBar.SetBackgroundImage(UIKit.UIImage.Empty, UIKit.UIBarMetrics.Default);
    }
}

方案2：优化事件订阅避免内存泄漏

记得在自定义导航页的Dispose方法中解绑RequestedThemeChanged事件，防止内存泄漏：

protected override void Dispose(bool disposing)
{
    if (disposing)
    {
        Application.Current!.RequestedThemeChanged -= (_, _) => SetBarColors();
    }
    base.Dispose(disposing);
}