UICollectionView动态计算宽度致Item显示不全问题求助

我之前踩过完全一样的坑！当你用estimatedItemSize配合Masonry做Cell的自动布局时，系统经常会因为估算尺寸和Cell真实尺寸不匹配，导致contentSize计算错误——最后一个Item就会被“卡”在可视区域外，拉不动，调contentInset根本没用，因为问题根源不在内边距，而是整个集合视图的可滚动范围算错了。

下面是针对你提到的三个文件（MainViewController、HeaderCollectionView、HeaderViewCell）的具体修复方案：

1. 给Cell的自动布局“打补丁”（HeaderViewCell） #

Masonry布局本身没问题，但系统默认的尺寸估算逻辑可能抓不到Cell的真实大小，所以我们要重写Cell的布局属性适配方法，强制返回正确的尺寸：

// HeaderViewCell.m
- (void)awakeFromNib {
    [super awakeFromNib];
    [self setupSubviews];
}

- (void)setupSubviews {
    // 这里是你原本的Masonry布局，比如给内部的Label加约束
    [self.titleLabel mas_makeConstraints:^(MASConstraintMaker *make) {
        // 关键：让子控件的约束完全撑开contentView的上下左右，确保尺寸能被正确计算
        make.edges.equalTo(self.contentView).insets(UIEdgeInsetsMake(8, 12, 8, 12));
    }];
}

// 重写这个方法，返回Cell的真实尺寸
- (CGSize)preferredLayoutAttributesFittingAttributes:(UICollectionViewLayoutAttributes *)layoutAttributes {
    // 先触发一次布局，确保子控件的尺寸都计算完毕
    [self layoutIfNeeded];
    
    // 用系统布局计算方法获取真实大小，这里水平方向用Required优先级，保证宽度计算准确
    CGSize fittingSize = [self.contentView systemLayoutSizeFittingSize:layoutAttributes.size
                                          withHorizontalFittingPriority:UILayoutPriorityRequired
                                                verticalFittingPriority:UILayoutPriorityFittingSizeLevel];
    
    // 更新布局属性的尺寸
    layoutAttributes.size = fittingSize;
    return fittingSize;
}

2. 修正CollectionView的布局配置（HeaderCollectionView） #

除了设置estimatedItemSize，还要确保FlowLayout的其他参数正确，并且在数据源更新后强制刷新布局：

// HeaderCollectionView.m
- (void)setupCollectionView {
    UICollectionViewFlowLayout *flowLayout = [[UICollectionViewFlowLayout alloc] init];
    
    // 开启自动尺寸估算
    flowLayout.estimatedItemSize = UICollectionViewFlowLayout.automaticSize;
    // 设置正确的间距，避免系统估算时的偏差
    flowLayout.minimumInteritemSpacing = 8;
    flowLayout.minimumLineSpacing = 8;
    // 如果有section内边距，也要明确设置
    flowLayout.sectionInset = UIEdgeInsetsMake(0, 16, 0, 16);
    
    self.collectionView = [[UICollectionView alloc] initWithFrame:CGRectZero collectionViewLayout:flowLayout];
    // 其他配置：注册Cell、设置代理数据源等...
    self.collectionView.backgroundColor = [UIColor whiteColor];
}

// 重载数据源时，强制刷新布局，让系统重新计算contentSize
- (void)updateWithData:(NSArray *)data {
    self.dataSourceArray = data;
    [self.collectionView reloadData];
    // 关键：手动触发布局失效，让系统重新计算所有Item的真实尺寸和contentSize
    [self.collectionView.collectionViewLayout invalidateLayout];
}

3. 确保CollectionView的Frame正确（MainViewController） #

有时候CollectionView的Frame还没确定就加载数据，也会导致尺寸计算错误，所以要在视图布局完成后再触发一次布局刷新：

// MainViewController.m
- (void)viewDidLayoutSubviews {
    [super viewDidLayoutSubviews];
    // 当视图布局完成后，强制刷新HeaderCollectionView的布局
    [self.headerCollectionView.collectionView.collectionViewLayout invalidateLayout];
}

// 如果是异步加载数据，还要在主线程刷新布局
- (void)fetchData {
    // 模拟异步请求数据
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
        NSArray *data = [self loadDataFromServer];
        dispatch_async(dispatch_get_main_queue(), ^{
            [self.headerCollectionView updateWithData:data];
            // 额外再触发一次布局刷新，确保万无一失
            [self.headerCollectionView.collectionView.collectionViewLayout invalidateLayout];
        });
    });
}

为什么这些修改能解决问题？ #

estimatedItemSize只是系统的一个“预估值”，当Cell用Masonry做自动布局时，系统可能无法实时捕获到Cell的真实宽度，导致contentSize计算偏小——最后一个Item就会被藏在计算出的滚动范围之外，自然拉不动也显示不全。

通过重写preferredLayoutAttributesFittingAttributes，我们强制告诉系统Cell的真实尺寸；而调用invalidateLayout会让系统完全重新计算整个布局，包括contentSize，这样滚动范围就准确了，最后一个Item就能正常显示和滚动了。

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