重写heightForRowAtIndexPath导致UITableViewCell出现异常黑色背景的问题咨询

我来帮你拆解这个问题——我之前做项目时也碰到过几乎一模一样的坑！这个黑色背景的问题本质上是cell复用机制+手动高度设置下的布局适配冲突，结合你的代码来看，主要有这几个核心原因：

核心原因分析 #

1. 重复添加子视图导致布局混乱 #

你在cellForRowAtIndexPath:里处理第一行cell时，每次都会直接创建trackInfoLabel并添加到contentView上，但cell是复用的！当这个cell被滑出屏幕再滑回来时，会重复添加多个label，不仅会导致界面错乱，还会干扰cell自身的bounds计算——这会让UITableView无法正确同步selectedBackgroundView的尺寸，最终让它的默认黑色背景暴露出来。

2. 手动高度下selectedBackgroundView的布局未被正确更新 #

当你返回UITableViewAutomaticDimension时，UITableView会自动完成完整的cell布局流程：从估算高度到最终确定高度，同时会自动调整selectedBackgroundView的frame以匹配cell的最终尺寸。但当你手动固定高度时，如果复用的cell之前是其他高度（比如默认的自动维度高度），selectedBackgroundView的frame可能不会被自动重置，它会保持之前的尺寸，和你设置的100px高度不匹配，超出或未覆盖的区域就会显示它的默认黑色。

3. Frame布局的不准确性 #

你用cell.contentView.frame来初始化trackInfoLabel的frame，但此时cell可能还没有完成布局（UITableView的cell布局是异步过程），这个frame是不准确的。而且复用的时候，这个label的frame不会自动更新，进一步加剧了cell布局的混乱，让系统无法正确处理selectedBackgroundView的适配。

解决方案 #

针对这些问题，我们可以一步步修复：

1. 避免重复添加子视图 #

给label设置唯一tag，每次先查找是否存在，不存在再创建；同时复用其他行时要清理第一行的label：

#define kTrackInfoLabelTag 1001

-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"cellID" forIndexPath:indexPath];
    if (cell == nil || cell.detailTextLabel == nil ){
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:@"cellID"];
    }
    // 重置cell内容
    cell.userInteractionEnabled = YES;
    cell.backgroundColor = [UIColor clearColor];
    cell.imageView.image = nil;
    cell.textLabel.text = nil;
    cell.detailTextLabel.text = nil;
    
    switch(indexPath.section) {
        case 0:{
            switch (indexPath.row) {
                case 0:{
                    NSAttributedString *myText = [[NSAttributedString alloc] initWithString:@"Test"];
                    // 先查找已有label
                    UILabel *trackInfoLabel = (UILabel *)[cell.contentView viewWithTag:kTrackInfoLabelTag];
                    if (!trackInfoLabel) {
                        trackInfoLabel = [[UILabel alloc] init];
                        trackInfoLabel.tag = kTrackInfoLabelTag;
                        trackInfoLabel.textAlignment = NSTextAlignmentCenter;
                        trackInfoLabel.contentMode = UIViewContentModeScaleAspectFit;
                        // 开启AutoLayout，替代frame布局
                        trackInfoLabel.translatesAutoresizingMaskIntoConstraints = NO;
                        [cell.contentView addSubview:trackInfoLabel];
                        // 添加约束确保label适配contentView
                        [NSLayoutConstraint activateConstraints:@[
                            [trackInfoLabel.leadingAnchor constraintEqualToAnchor:cell.contentView.leadingAnchor],
                            [trackInfoLabel.trailingAnchor constraintEqualToAnchor:cell.contentView.trailingAnchor],
                            [trackInfoLabel.topAnchor constraintEqualToAnchor:cell.contentView.topAnchor],
                            [trackInfoLabel.bottomAnchor constraintEqualToAnchor:cell.contentView.bottomAnchor]
                        ]];
                    }
                    trackInfoLabel.attributedText = myText;
                    break;
                }
                default:
                    // 复用的时候移除第一行的label（如果当前cell是从第一行复用过来的）
                    UILabel *trackInfoLabel = (UILabel *)[cell.contentView viewWithTag:kTrackInfoLabelTag];
                    if (trackInfoLabel) {
                        [trackInfoLabel removeFromSuperview];
                    }
                    break;
            }
        }
    }
    return cell;
}

2. 手动确保selectedBackgroundView适配cell尺寸 #

在cell初始化时自定义selectedBackgroundView，并设置自动调整mask，确保它能跟随cell的尺寸变化：

// 在cell初始化的代码块里添加
if (cell == nil || cell.detailTextLabel == nil ){
    cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:@"cellID"];
    // 自定义selectedBackgroundView，避免默认黑色
    UIView *selectedView = [[UIView alloc] initWithFrame:cell.bounds];
    selectedView.backgroundColor = [UIColor clearColor]; // 也可以设置你想要的选中背景色
    selectedView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
    cell.selectedBackgroundView = selectedView;
}

这样不管cell高度怎么变，selectedBackgroundView都会自动适配，不会出现黑色背景。

3. 补充设置estimatedRowHeight #

即使你手动设置了部分cell的高度，建议在UITableView初始化时设置估算高度，帮助系统更准确地处理布局：

self.tableView.estimatedRowHeight = 44.0f;
self.tableView.rowHeight = UITableViewAutomaticDimension;

总结 #

本质上这个问题是手动高度设置打破了UITableView自动布局的流程，加上cell复用导致的布局冲突，只要解决重复子视图的问题，确保selectedBackgroundView能正确适配cell尺寸，再配合AutoLayout替代frame布局，就能彻底解决这个黑色背景的问题。

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