Swift 滚动 tableView 时带 ImageView 的透明表头变为白色如何解决

问题现象 #

滚动UITableView时表头背景色异常变为白色，该问题由系统私有视图_UIVisualEffectBackdropView的自动渲染逻辑导致，对应效果参考：

• 未滚动时正常状态：
• 滚动时表头变白异常状态：

解决方案 #

方案1：手动指定表头背景视图（推荐，无私有API依赖） #

在表头生成的代理方法中，主动给表头设置自定义背景视图，覆盖系统默认生成的带模糊效果的背景层，Swift示例代码如下：

func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    let header = // 你的自定义表头实例
    // 自定义背景视图替换系统默认背景
    let customBackground = UIView()
    customBackground.backgroundColor = .systemBlue // 替换为你需要的实际背景色
    header.backgroundView = customBackground
    return header
}

Objective-C示例代码：

- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    UITableViewHeaderFooterView *header = // 你的自定义表头实例
    UIView *customBackground = [[UIView alloc] init];
    customBackground.backgroundColor = [UIColor systemBlueColor]; // 替换为实际背景色
    header.backgroundView = customBackground;
    return header;
}

方案2：禁用系统自动插入的模糊背景层 #

在表头即将显示的代理方法中，遍历子视图找到私有背影视图直接隐藏，适配全系统版本：

func tableView(_ tableView: UITableView, willDisplayHeaderView view: UIView, forSection section: Int) {
    for subview in view.subviews {
        guard let effectView = subview as? UIVisualEffectView else { continue }
        // 匹配_UIVisualEffectBackdropView私有视图
        for effectSubview in effectView.subviews {
            let className = NSStringFromClass(type(of: effectSubview))
            if className.contains("_UIVisualEffectBackdropView") {
                effectSubview.isHidden = true
                // 也可直接移除模糊效果：effectView.effect = nil
            }
        }
    }
}

方案3：适配iOS15+新增的表头间距特性 #

iOS15及以上系统默认给分组表头增加了顶部填充，同时会自动生成背景层，可全局关闭该特性：

if #available(iOS 15.0, *) {
    UITableView.appearance().sectionHeaderTopPadding = 0
    // 仅需当前页面生效则替换为：tableView.sectionHeaderTopPadding = 0
}

内容的提问来源于stack exchange，提问作者Théo Rohmer