UIScrollView无法识别UICollectionView的contentSize问题求助

你的问题核心在于：当UICollectionView禁用滚动（isScrollEnabled = false）并嵌套在UIScrollView的contentView中时，Auto Layout无法自动推断它的高度。因为默认情况下，UICollectionView的contentSize是动态计算的，但Auto Layout需要明确的尺寸约束才能确定视图的框架，否则会被压缩到0高度，导致你看不到它。

下面是两种可靠的解决方案，结合你的代码给出具体修改：

方案一：通过KVO监听contentSize动态更新高度约束 #

这种方法直接在ViewController中处理，不需要自定义CollectionView：

1. 首先给你的collectionView添加一个高度约束的引用（在VC的属性里声明）：

private var collectionViewHeightConstraint: NSLayoutConstraint!

2. 在configureCollectionView()方法中，替换原来的约束设置，保存高度约束的引用：

private func configureCollectionView() {
    collectionView.backgroundColor = .clear
    collectionView.delegate = self
    collectionView.dataSource = self
    collectionView.isScrollEnabled = false
    
    collectionView.register(CustomCollectionViewCell.self, forCellWithReuseIdentifier: customCellId)
    collectionView.register(CustomHeaderCollectionReusableView.self, forSupplementaryViewOfKind: UICollectionView.elementKindSectionHeader, withReuseIdentifier: customHeaderId)
    
    collectionView.translatesAutoresizingMaskIntoConstraints = false
    collectionView.topAnchor.constraint(equalTo: customContainerView.bottomAnchor).isActive = true
    collectionView.leftAnchor.constraint(equalTo: scrollView.contentView.leftAnchor).isActive = true
    collectionView.rightAnchor.constraint(equalTo: scrollView.contentView.rightAnchor).isActive = true
    collectionView.bottomAnchor.constraint(equalTo: scrollView.contentView.bottomAnchor).isActive = true
    
    // 添加高度约束，初始值设为0，后续动态更新
    collectionViewHeightConstraint = collectionView.heightAnchor.constraint(equalToConstant: 0)
    collectionViewHeightConstraint.isActive = true
    
    // 监听contentSize变化
    collectionView.addObserver(self, forKeyPath: "contentSize", options: [.new], context: nil)
}

3. 实现KVO的回调方法，更新高度约束：

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    if keyPath == "contentSize" && object === collectionView {
        guard let newSize = change?[.newKey] as? CGSize else { return }
        // 更新高度约束为contentSize的高度
        collectionViewHeightConstraint.constant = newSize.height
    } else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
    }
}

4. 记得在VC销毁时移除观察者，避免内存泄漏：

deinit {
    collectionView.removeObserver(self, forKeyPath: "contentSize")
}

方案二：自定义UICollectionView子类，封装自适应逻辑 #

这种方法更优雅，把高度自适应的逻辑封装在CollectionView内部，ViewController不需要额外处理KVO：

1. 创建自定义CollectionView类：

class SelfSizedCollectionView: UICollectionView {
    override var contentSize: CGSize {
        didSet {
            // contentSize变化时，触发intrinsicContentSize更新
            invalidateIntrinsicContentSize()
        }
    }
    
    override var intrinsicContentSize: CGSize {
        // 把contentSize的高度作为intrinsicContentSize的高度
        return CGSize(width: UIView.noIntrinsicMetric, height: contentSize.height)
    }
}

2. 在你的ViewController中，把原来的collectionView类型替换为SelfSizedCollectionView：

// 声明时修改类型
private let collectionView = SelfSizedCollectionView(frame: .zero, collectionViewLayout: UICollectionViewFlowLayout())

3. 然后在configureCollectionView()中，只需要保证collectionView的左右上下约束正确，不需要设置高度约束（因为它会通过intrinsicContentSize自动提供高度）：

private func configureCollectionView() {
    collectionView.backgroundColor = .clear
    collectionView.delegate = self
    collectionView.dataSource = self
    collectionView.isScrollEnabled = false
    
    collectionView.register(CustomCollectionViewCell.self, forCellWithReuseIdentifier: customCellId)
    collectionView.register(CustomHeaderCollectionReusableView.self, forSupplementaryViewOfKind: UICollectionView.elementKindSectionHeader, withReuseIdentifier: customHeaderId)
    
    collectionView.translatesAutoresizingMaskIntoConstraints = false
    collectionView.topAnchor.constraint(equalTo: customContainerView.bottomAnchor).isActive = true
    collectionView.leftAnchor.constraint(equalTo: scrollView.contentView.leftAnchor).isActive = true
    collectionView.rightAnchor.constraint(equalTo: scrollView.contentView.rightAnchor).isActive = true
    collectionView.bottomAnchor.constraint(equalTo: scrollView.contentView.bottomAnchor).isActive = true
}

额外注意事项 #

• 确保你的UICollectionViewCell和UICollectionReusableView的约束是完整的，能够正确计算出cell的高度（如果是flow layout，要正确设置itemSize或者实现collectionView(_:layout:sizeForItemAt:)方法），否则collectionView的contentSize会计算错误，导致自适应高度失效。
• 如果你使用的是UICollectionViewCompositionalLayout，也要确保section的布局能够正确计算出整体的content高度。

这样修改后，你的UICollectionView就能根据自身的contentSize自动调整高度，并且在UIScrollView中正常显示了。

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