推送仅含TableView的ViewController时导航栏异常问题求助

我之前也碰到过类似的导航栏滚动重绘异常的问题，看了你的代码后，发现几个核心问题点，帮你梳理下解决方案：

1. 直接给导航栏添加子视图是核心诱因 #

你通过navigationBar.addSubview(imageView!)直接给导航栏加自定义视图，这违背了UINavigationBar的官方布局逻辑：

• 导航栏在TableView滚动触发状态切换（比如大标题/普通标题切换、背景透明度变化）时，会自动重绘内部视图层级，你手动添加的子视图不在系统的管理体系内，很容易出现布局错位、整体重绘的异常。

解决方法：
根据你的需求选择官方支持的自定义方式：

• 如果这个imageView是导航栏背景图：通过UINavigationBarAppearance的backgroundImage设置
• 如果是自定义标题视图：在目标ViewController的navigationItem.titleView中设置，而非全局给导航控制器加子视图

示例代码（背景图方式）：

let appearance = UINavigationBarAppearance()
// ... 保留你的其他外观设置
// 假设你有对应的UIImage实例
let navBgImage = UIImage(named: "your-bg-image")
appearance.backgroundImage = navBgImage
appearance.backgroundImageContentMode = .scaleAspectFit // 按需调整适配模式

示例代码（自定义标题视图，在目标ViewController的viewDidLoad中）：

let imageView = UIImageView(image: yourImage)
imageView.contentMode = .scaleAspectFit
// 可以给imageView加约束或者设置sizeToFit
imageView.sizeToFit()
navigationItem.titleView = imageView

2. 错误设置accessibilityFrame干扰布局 #

你手动指定了appearance.accessibilityFrame，这个属性是给无障碍功能使用的，完全不应该用来控制导航栏的尺寸。导航栏的高度（包括刘海屏安全区）是系统自动管理的，手动设置这个值会干扰系统的布局计算，引发重绘异常。

解决方法：直接删掉这行代码：

// 移除这行
appearance.accessibilityFrame = CGRect(x: 0, y: 0, width: UIApplication.shared.windows.first?.frame.size.width ?? 500, height: 100)

3. clipsToBounds可能加剧裁剪异常 #

self.navigationBar.clipsToBounds = true会强制裁剪导航栏超出边界的内容，在导航栏状态切换时，内部视图的位置变化可能被错误裁剪，放大重绘问题。

解决方法：如果不是必须保留，直接移除这行代码；如果确实需要裁剪，确保所有自定义视图都通过官方方式添加，完全处于导航栏的 bounds 范围内。

修改后的完整代码示例 #

override func viewDidLoad() {
    super.viewDidLoad()
    
    let appearance = UINavigationBarAppearance()
    appearance.configureWithOpaqueBackground()
    appearance.backgroundColor = .primaryColor
    appearance.titleTextAttributes = [.foregroundColor: UIColor.white]
    appearance.largeTitleTextAttributes = [.foregroundColor: UIColor.white]
    
    // 可选：设置背景图
    // let navBgImage = UIImage(named: "your-bg-image")
    // appearance.backgroundImage = navBgImage
    // appearance.backgroundImageContentMode = .scaleAspectFit
    
    navigationItem.standardAppearance = appearance
    navigationItem.scrollEdgeAppearance = appearance
    navigationItem.compactAppearance = appearance
    
    self.navigationBar.prefersLargeTitles = true
    
    // 移除以下两行及对应的约束代码
    // self.navigationBar.clipsToBounds = true
    // self.navigationBar.addSubview(imageView!)
    // ... 之前的imageView约束代码
}

按照上面的修改后，再推送那个仅含TableView的ViewController，导航栏的滚动重绘异常应该就能解决了——现在所有自定义都遵循系统的布局逻辑，状态切换时会被正确处理。

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