升级iOS 15后顶部导航栏背景消失问题如何解决？

核心原因 #

iOS 15 对 UINavigationBar 的外观默认配置做了调整，新增的scrollEdgeAppearance属性默认使用透明背景，当页面无滚动内容、或滚动到顶部时，导航栏就会呈现透明效果，仅显示文字和按钮。

修复方法 #

方法1：全局统一配置导航栏样式（推荐） #

在App启动入口（一般是AppDelegate的didFinishLaunchingWithOptions方法里）添加全局配置代码：

// Objective-C 代码
if (@available(iOS 15.0, *)) {
    UINavigationBarAppearance *appearance = [[UINavigationBarAppearance alloc] init];
    // 配置导航栏背景色，可替换为自定义颜色
    [appearance configureWithOpaqueBackground];
    appearance.backgroundColor = [UIColor whiteColor];
    // 同时对齐普通状态和滚动到边缘的样式
    [UINavigationBar appearance].standardAppearance = appearance;
    [UINavigationBar appearance].scrollEdgeAppearance = appearance;
}

// Swift 代码
if #available(iOS 15.0, *) {
    let appearance = UINavigationBarAppearance()
    appearance.configureWithOpaqueBackground()
    appearance.backgroundColor = .white // 替换为自定义背景色
    UINavigationBar.appearance().standardAppearance = appearance
    UINavigationBar.appearance().scrollEdgeAppearance = appearance
}

方法2：Storyboard 单独配置 #

你使用Storyboard配置segue，可直接在可视化面板调整：

• 打开对应导航控制器的Interface Builder面板，选中导航栏
• 在属性检查器（Attribute Inspector）找到 Scroll Edge Appearance 选项
• 将其从默认的Transparent改为Standard，即可和普通状态样式保持一致

方法3：单个视图控制器单独配置 #

如果仅需要修改单个页面的导航栏样式，在对应控制器的viewDidLoad方法中添加配置：

// Swift 代码
if #available(iOS 15.0, *) {
    let appearance = UINavigationBarAppearance()
    appearance.configureWithOpaqueBackground()
    appearance.backgroundColor = .white
    navigationController?.navigationBar.standardAppearance = appearance
    navigationController?.navigationBar.scrollEdgeAppearance = appearance
}

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