UIImageView无法滚动问题求助：UICollectionView正常，已试ScrollView无效

方案一：使用UICollectionView头部视图（推荐） #

直接将顶部UIImageView作为UICollectionView的section header，利用CollectionView自身的滚动特性实现整体滚动，无需额外嵌套ScrollView，代码更简洁且符合iOS布局规范。

步骤1：修改CollectionView初始化代码 #

注册头部视图并设置头部尺寸：

private let collectionView: UICollectionView = {
    let layout = UICollectionViewFlowLayout()
    // 设置头部视图高度与原ImageView一致
    layout.headerReferenceSize = CGSize(width: UIScreen.main.bounds.width, height: 400)
    let collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
    // 注册自定义头部视图
    collectionView.register(ArtistHeaderView.self, forSupplementaryViewOfKind: UICollectionView.elementKindSectionHeader, withReuseIdentifier: "ArtistHeader")
    return collectionView
}()

步骤2：创建自定义头部视图类 #

class ArtistHeaderView: UICollectionReusableView {
    let artistImageView = UIImageView()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupUI()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupUI() {
        addSubview(artistImageView)
        // 设置ImageView铺满头部视图
        artistImageView.edgesToSuperview()
        artistImageView.layer.cornerRadius = 5
        artistImageView.clipsToBounds = true
        artistImageView.contentMode = .scaleAspectFill
    }
    
    // 提供配置方法加载图片
    func configure(with imageUrl: URL?) {
        artistImageView.kf.setImage(with: imageUrl, placeholder: .none)
    }
}

步骤3：调整视图添加逻辑 #

移除原addImageView方法，仅保留CollectionView的布局代码：

private func addCollectionView() {
    view.addSubview(collectionView)
    collectionView.edgesToSuperview(usingSafeArea: true)
    // 记得设置CollectionView的dataSource和delegate
    collectionView.dataSource = self
    collectionView.delegate = self
}

步骤4：实现CollectionView代理方法 #

在控制器的扩展中实现头部视图的创建逻辑：

extension YourViewController: UICollectionViewDataSource, UICollectionViewDelegate {
    // 其他数据源方法（如cell创建）保持不变
    
    func collectionView(_ collectionView: UICollectionView, viewForSupplementaryElementOfKind kind: String, at indexPath: IndexPath) -> UICollectionReusableView {
        guard kind == UICollectionView.elementKindSectionHeader else {
            return UICollectionReusableView()
        }
        let header = collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: "ArtistHeader", for: indexPath) as! ArtistHeaderView
        header.configure(with: viewModel.artistImage?.convertUrl)
        return header
    }
}

方案二：正确嵌套UIScrollView #

如果坚持使用UIScrollView，需要确保所有子视图都放在ScrollView的contentView中，并正确设置约束让ScrollView能计算出滚动区域。

步骤1：添加ScrollView和ContentView #

private let scrollView = UIScrollView()
private let contentView = UIView()
private let collectionView: UICollectionView = {
    let layout = UICollectionViewFlowLayout()
    let collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
    // 禁止CollectionView自身滚动，由外层ScrollView控制整体滚动
    collectionView.isScrollEnabled = false
    return collectionView
}()
private let artistImageView = UIImageView()

步骤2：设置ScrollView布局 #

private func setupScrollView() {
    view.addSubview(scrollView)
    scrollView.edgesToSuperview(usingSafeArea: true)
    
    scrollView.addSubview(contentView)
    // ContentView与ScrollView四边对齐，宽度绑定ScrollView宽度避免横向滚动
    contentView.edgesToSuperview()
    contentView.widthToSuperview()
}

private func addImageView() {
    contentView.addSubview(artistImageView)
    artistImageView.edgesToSuperview(excluding: .bottom)
    artistImageView.height(400)
    artistImageView.kf.setImage(with: viewModel.artistImage?.convertUrl, placeholder: .none)
    artistImageView.layer.cornerRadius = 5
    artistImageView.clipsToBounds = true
    artistImageView.contentMode = .scaleAspectFill
}

private func addCollectionView() {
    contentView.addSubview(collectionView)
    collectionView.topToBottom(of: artistImageView)
    collectionView.edgesToSuperview(excluding: .top)
    
    // 添加高度约束，后续通过监听contentSize更新高度
    collectionViewHeightConstraint = collectionView.heightAnchor.constraint(equalToConstant: 0)
    collectionViewHeightConstraint?.isActive = true
}

步骤3：监听CollectionView内容高度变化 #

通过KVO监听CollectionView的contentSize，动态更新其高度约束，确保ScrollView能正确计算滚动区域：

private var collectionViewHeightConstraint: NSLayoutConstraint?

override func viewDidLoad() {
    super.viewDidLoad()
    setupScrollView()
    addImageView()
    addCollectionView()
    
    // 监听contentSize变化
    collectionView.addObserver(self, forKeyPath: "contentSize", options: [.new], context: nil)
}

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    if keyPath == "contentSize", let newSize = change?[.newKey] as? CGSize {
        collectionViewHeightConstraint?.constant = newSize.height
    }
}

deinit {
    // 移除监听避免内存泄漏
    collectionView.removeObserver(self, forKeyPath: "contentSize")
}

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