如何用Objective-C解决UITableView SectionHeader约束Xcode9.3兼容问题

看起来你遇到了Xcode版本升级后Auto Layout约束失效的典型问题——旧版本兼容的约束写法在Xcode 9+的严格布局检查下触发了冲突，导致视图被压缩至不可见。下面我来帮你拆解原因并给出可行的解决办法：

核心问题排查 #

1. 约束冲突：你加载的BasicProdInfoSectionHeaderView nib文件里可能自带了固定宽度的约束，和你手动添加的全屏约束（H:|[_sectionHeaderView]|）产生冲突，新版本Xcode会优先处理冲突，最终导致视图被隐藏；
2. Header布局逻辑变化：Xcode 9之后，UITableView的section header宽度由tableView自动控制，手动给secHeaderView设置frame再叠加Auto Layout约束，容易触发布局计算混乱；
3. VFL写法的歧义：旧版本对VFL的容错性更高，新版本会严格校验约束的合理性，可能你的VFL写法在新环境下被判定为无效。

解决方案（按推荐程度排序） #

方案1：直接返回Nib视图作为Header（最简洁）

不需要额外嵌套secHeaderView，直接把从Nib加载的视图作为section header，让tableView自动处理宽度，同时给视图添加阴影即可：

- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    _sectionHeaderView = [[NSBundle mainBundle] loadNibNamed:@"BasicProdInfoSectionHeaderView" owner:self options:nil].firstObject;
    SectionHeader *currentHeader = [self.titleStringArray objectAtIndex:section];
    [_sectionHeaderView setTitleWithText:currentHeader.titleLabel];
    _sectionHeaderView.expandableButton.tag = section;
    [_sectionHeaderView.expandableButton addTarget:self action:@selector(expandButtonClicked:) forControlEvents:UIControlEventTouchUpInside];

    // 处理阴影（注意要关闭masksToBounds才能显示阴影）
    if (section != 3) {
        _sectionHeaderView.layer.shadowOffset = CGSizeMake(0, 1);
        _sectionHeaderView.layer.shadowRadius = 1;
        _sectionHeaderView.layer.shadowColor = [UIColor blackColor].CGColor;
        _sectionHeaderView.layer.shadowOpacity = 0.25;
        _sectionHeaderView.layer.masksToBounds = NO;
    }

    return _sectionHeaderView;
}

同时记得实现header高度的代理方法：

- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
    return 50; // 和你原本期望的高度一致
}

方案2：修复嵌套视图的约束写法

如果必须保留secHeaderView作为容器，改用锚点约束替代VFL，避免歧义，同时不要手动设置frame：

- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    _sectionHeaderView = [[NSBundle mainBundle] loadNibNamed:@"BasicProdInfoSectionHeaderView" owner:self options:nil].firstObject;
    SectionHeader *currentHeader = [self.titleStringArray objectAtIndex:section];
    [_sectionHeaderView setTitleWithText:currentHeader.titleLabel];
    _sectionHeaderView.expandableButton.tag = section;
    [_sectionHeaderView.expandableButton addTarget:self action:@selector(expandButtonClicked:) forControlEvents:UIControlEventTouchUpInside];

    UIView *secHeaderView = [[UIView alloc] init];
    _sectionHeaderView.translatesAutoresizingMaskIntoConstraints = NO;
    [secHeaderView addSubview:_sectionHeaderView];

    // 使用锚点约束明确绑定四边
    [NSLayoutConstraint activateConstraints:@[
        [_sectionHeaderView.leadingAnchor constraintEqualToAnchor:secHeaderView.leadingAnchor],
        [_sectionHeaderView.trailingAnchor constraintEqualToAnchor:secHeaderView.trailingAnchor],
        [_sectionHeaderView.topAnchor constraintEqualToAnchor:secHeaderView.topAnchor],
        [_sectionHeaderView.bottomAnchor constraintEqualToAnchor:secHeaderView.bottomAnchor]
    ]];

    if (section != 3) {
        secHeaderView.layer.shadowOffset = CGSizeMake(0, 1);
        secHeaderView.layer.shadowRadius = 1;
        secHeaderView.layer.shadowColor = [UIColor blackColor].CGColor;
        secHeaderView.layer.shadowOpacity = 0.25;
    }
    return secHeaderView;
}

方案3：排查Nib内的约束冲突

打开你的BasicProdInfoSectionHeaderView nib文件，删除所有固定宽度的约束（比如直接设置宽度为某个具体数值的约束），只保留高度或内容自适应的约束，这样外部添加的全屏约束就不会和内部约束冲突了。

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