iOS 15系统下为导航栏添加阴影效果的可行方案求助

失效原因 #

iOS 15 起 UIKit 重构了导航栏的渲染逻辑，默认通过UINavigationBarAppearance统一接管导航栏的背景、分隔线、阴影样式，直接修改navigationBar.layer的阴影属性会被系统默认外观配置覆盖，原有设置全部失效。

兼容实现代码 #

以下代码可在iOS 13+系统稳定运行，实现预期阴影效果：

// 初始化导航栏外观配置
let navAppearance = UINavigationBarAppearance()
// 根据导航栏实际背景选择对应配置：不透明纯色背景用configureWithOpaqueBackground，毛玻璃/透明背景按需选择configureWithDefaultBackground或configureWithTransparentBackground
navAppearance.configureWithOpaqueBackground()
navAppearance.backgroundColor = .white // 替换为当前导航栏实际背景色
// 清空系统默认的底部分隔线，避免和自定义阴影冲突
navAppearance.shadowColor = .clear

// 将外观配置应用到导航栏所有展示状态
navigationController?.navigationBar.standardAppearance = navAppearance
navigationController?.navigationBar.scrollEdgeAppearance = navAppearance
if #available(iOS 15.0, *) {
    navigationController?.navigationBar.compactAppearance = navAppearance
}

// 配置自定义阴影参数
navigationController?.navigationBar.layer.shadowColor = UIColor.baseGray.cgColor
navigationController?.navigationBar.layer.shadowOffset = CGSize(width: 0.0, height: 2.0)
navigationController?.navigationBar.layer.shadowRadius = 10.0
navigationController?.navigationBar.layer.shadowOpacity = 0.25
navigationController?.navigationBar.layer.masksToBounds = false

避坑说明 #

• 必须先完成UINavigationBarAppearance的配置和赋值，否则系统会在每次布局刷新时重置导航栏layer属性，阴影会随机消失
• 配置逻辑建议放在viewDidLoad或全局导航栏初始化方法中，不要写在viewWillAppear、viewWillLayoutSubviews等高频触发的生命周期回调里，避免被系统配置反复覆盖
• 如果项目里用了UIAppearance做全局导航栏样式统一，要确认全局配置没有强制设置shadowImage、shadowColor属性，否则会和当前页面的自定义阴影冲突

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