升级旧Xcode项目适配iOS15时navigationBar背景超出自身高度问题

问题排查及解决方案 #

以下是该类iOS 15导航栏异常的常见成因和对应验证方案：

• UINavigationBarAppearance 未显式配置
  iOS 15 对导航栏外观逻辑做了大幅变更，未显式配置时系统默认会给导航栏的背景承载视图（_UIBarBackground）添加额外的延伸渲染区域，覆盖状态栏下方到导航栏下方的部分空间，即使导航栏本身的intrinsicContentSize仍然是标准44pt。可先添加如下代码强制配置导航栏外观，关闭默认延伸效果：

// Swift 版本
if #available(iOS 15.0, *) {
    let navAppearance = UINavigationBarAppearance()
    // 强制使用不透明背景，移除系统默认的模糊延伸效果
    navAppearance.configureWithOpaqueBackground()
    // 清除默认阴影线的额外渲染区域
    navAppearance.shadowColor = .clear
    // 同时配置两种状态的外观，避免滚动时出现差异
    navigationController?.navigationBar.standardAppearance = navAppearance
    navigationController?.navigationBar.scrollEdgeAppearance = navAppearance
}

// Objective-C 版本
if (@available(iOS 15.0, *)) {
    UINavigationBarAppearance *navAppearance = [[UINavigationBarAppearance alloc] init];
    [navAppearance configureWithOpaqueBackground];
    navAppearance.shadowColor = [UIColor clearColor];
    self.navigationController.navigationBar.standardAppearance = navAppearance;
    self.navigationController.navigationBar.scrollEdgeAppearance = navAppearance;
}

• 延伸布局属性未适配
  iOS 11 时期的项目默认会开启视图的全屏延伸布局，到iOS 15后系统对该逻辑的处理有所调整，会自动将滚动视图的顶部内容区域延伸到导航栏下方，同时导航栏背景会覆盖该部分区域，看起来就像导航栏背景高度超出本身尺寸。可尝试显式关闭当前视图控制器的延伸布局：
  self.edgesForExtendedLayout = UIRectEdgeNone;（Objective-C）或 edgesForExtendedLayout = []（Swift）
• 滚动视图内边距自动调整异常
  如果当前页面包含UIScrollView及其子类（UITableView、UICollectionView等），可检查滚动视图的 contentInsetAdjustmentBehavior 属性，iOS 13之后该属性默认为 .automatic，会自动给滚动视图添加适配导航栏的顶部内边距，如果你手动修改过滚动视图的frame或内边距，就可能出现内容从导航栏后方穿过、背景溢出的问题，可尝试将该属性设为 .never 验证是否恢复正常。
• 自定义导航栏逻辑兼容问题
  如果项目中存在自定义导航栏分类、全局导航栏样式修改的代码，可逐一排查是否有iOS 15不兼容的API调用，比如旧版本直接修改 backgroundImage、shadowImage 的逻辑在iOS 15之后优先级低于 UINavigationBarAppearance 的配置，可能导致背景渲染异常。你也可以通过Xcode的视图调试功能（Debug View Hierarchy）直接查看导航栏的子视图层级，定位是哪个子视图超出了44pt的导航栏本身frame，针对性调整即可。

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