UICollectionView内容不足时拦截垂直Pan手势致外层UIScrollView无法滚动的问题排查与解决

这问题我之前做嵌套滚动场景时也踩过坑，本质是UICollectionView作为UIScrollView子类的手势识别逻辑导致的：

• 当UICollectionView的内容宽度不足以支撑横向滚动时，它内部的UIPanGestureRecognizer会默认认为自己可以处理垂直方向的拖动（毕竟横向不需要滚动了）。
• 由于手势识别的响应优先级，内层的UICollectionView会先拦截垂直Pan手势，外层的UIScrollView根本接收不到这个手势事件，自然没法滚动。

我整理了两种靠谱的解决方式，你可以根据自己的业务场景选择：

方案一：自定义UICollectionView，过滤垂直手势 #

通过重写gestureRecognizerShouldBegin:方法，让UICollectionView只响应横向的Pan手势，垂直手势直接放弃处理，交给外层滚动视图。这是最灵活的方案，能动态适配内容多少的情况。

代码实现：

@interface CustomHorizontalCollectionView : UICollectionView
@end

@implementation CustomHorizontalCollectionView

- (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer {
    if ([gestureRecognizer isKindOfClass:[UIPanGestureRecognizer class]]) {
        UIPanGestureRecognizer *panGesture = (UIPanGestureRecognizer *)gestureRecognizer;
        CGPoint velocity = [panGesture velocityInView:self];
        
        // 比较垂直和水平方向的速度，垂直方向更快则不响应该手势
        if (ABS(velocity.y) > ABS(velocity.x)) {
            return NO;
        }
    }
    return [super gestureRecognizerShouldBegin:gestureRecognizer];
}

@end

之后把你原代码里的UICollectionView替换成这个自定义类就行——内容足够时正常横向滚动，内容不足时垂直手势自动交给外层，完全不影响交互体验。

方案二：根据内容动态设置scrollEnabled #

另一种思路是，当UICollectionView的内容宽度小于等于自身宽度时，直接禁用它的滚动功能，这样它的手势识别器就不会拦截任何Pan手势：

// 在UICollectionView数据源更新完成后调用
- (void)updateCollectionViewScrollStatus {
    CGSize contentSize = self.collectionView.contentSize;
    CGSize boundsSize = self.collectionView.bounds.size;
    // 考虑sectionInset的影响，计算实际可滚动的内容宽度
    CGFloat actualContentWidth = contentSize.width - self.collectionView.contentInset.left - self.collectionView.contentInset.right;
    self.collectionView.scrollEnabled = actualContentWidth > boundsSize.width;
}

你可以在reloadData之后或者layoutSubviews方法里调用这个方法。不过这个方案有个小缺点：如果后续内容动态增加，需要重新计算并开启滚动，否则用户没法横向滑动。

如果你的项目是Swift语言，逻辑完全一致，只是语法不同：

class CustomHorizontalCollectionView: UICollectionView {
    override func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
        if let panGesture = gestureRecognizer as? UIPanGestureRecognizer {
            let velocity = panGesture.velocity(in: self)
            if abs(velocity.y) > abs(velocity.x) {
                return false
            }
        }
        return super.gestureRecognizerShouldBegin(gestureRecognizer)
    }
}

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