如何在无UITableView场景下为UIScrollView实现可正常触发的下拉刷新

核心问题排查方向 #

• 首先校验UIScrollView的基础运行状态
  UIRefreshControl 本质是依附于scrollView的垂直回弹能力触发的，如果scrollView本身没有正常运行，下拉逻辑从根源上就不会生效。
  需优先排查最高发的问题点：
  1. 初始化的scrollView实例是否已经通过view.addSubview(scrollView)加入控制器视图层级，是否配置了完整的AutoLayout约束（比如上下左右都贴边到安全区）——很多人只声明了scrollView实例，没有完成上述配置，导致scrollView实际frame为零，完全无法响应交互。
  2. 结合已开启的alwaysBounceVertical = true属性，只要scrollView有正常的可视frame，哪怕内部没有任何子内容、contentSize为零，也可以支持垂直下拉回弹。如果连可视frame都不对，再好的配置也不会生效。
• 其次排查UIRefreshControl的添加方式是否合规
  从iOS 10开始，UIScrollView原生支持refreshControl属性，手动将refreshControl作为普通子视图addSubview到scrollView上的写法，在新版本系统中存在兼容问题：这种方式不会把refreshControl纳入scrollView的事件响应链，哪怕能看到下拉的进度，也不会正确触发.valueChanged事件。
  需将原来的self.scrollView.addSubview(refreshControl)替换为系统原生赋值方式：
  scrollView.refreshControl = refreshControl
• 最后排查事件拦截问题
  检查scrollView及其子视图的交互配置：
  1. 确认scrollView的isUserInteractionEnabled没有被误设为false
  2. 确认scrollView上层没有覆盖透明/不透明的无交互控件，拦截了下拉的手势事件

优化后的完整可运行配置代码 #

private func setupRefreshControl() {    
    scrollView.alwaysBounceVertical = true
    scrollView.bounces  = true
    refreshControl.addTarget(self, action: #selector(updateView), for: .valueChanged)
    // 替换手动addSubview为系统属性赋值
    scrollView.refreshControl = refreshControl
}
    
@objc func updateView() {
    SyncScheduler.syncImmediately(
        success: { [weak self] in
            // 补充弱引用避免循环引用
            self?.refreshControl.endRefreshing()
        },
        failure: { [weak self] errorMessage in
            self?.present(message: errorMessage, style: .error)
            self?.refreshControl.endRefreshing()
        }
    )
}

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