iOS 17中UIRefreshControl调用beginRefreshing不显示问题求助

问题重现 #

原有代码在 iOS 14/15/16 运行正常，但升级到 iOS 17 + Xcode 15 后，在 viewDidLoad 中提前调用 refreshControl.beginRefreshing() 时，刷新控件不显示，同时控制台输出警告：refresh control received offscreen beginRefreshing。

原因分析 #

iOS 17 对 UIRefreshControl 的显示逻辑做了严格校验：只有当控件处于屏幕可见范围内（即所属 UITableView 完成布局计算）时，调用 beginRefreshing() 才会触发显示动画。而 viewDidLoad 阶段，UITableView 刚被添加到视图层级，还未完成布局计算，此时 RefreshControl 处于「屏幕外」状态，直接调用方法会触发警告且无显示效果。

修复方案 #

无需依赖 viewDidAppear/viewWillAppear（避免重复执行请求），只需确保 UITableView 完成布局后再调用 beginRefreshing()，同时手动调整 tableView 偏移量保证控件可见。

修改后的代码示例 #

class ViewController: UIViewController, UITableViewDataSource, UITableViewDelegate {
    private let tableView = UITableView()
    private let cellIdentifier = "cellIdentifier"
    private let data = ["Cell 1", "Cell 2"]
    private let refreshControl = UIRefreshControl()

    override func viewDidLoad() {
        super.viewDidLoad()
        configureTableView()
        
        // 等待当前 RunLoop 结束，确保 tableView 完成布局
        DispatchQueue.main.async {
            self.refreshControl.beginRefreshing()
            // 手动调整 tableView 偏移量，让刷新控件显示在屏幕内
            let offsetY = -self.refreshControl.frame.height
            self.tableView.setContentOffset(CGPoint(x: 0, y: offsetY), animated: false)
        }
        
        // 模拟请求（仅在 viewDidLoad 执行一次）
        DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
            self.setDataSource()
        }
    }
    
    private func configureTableView() {
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: cellIdentifier)
        refreshControl.addTarget(self, action: #selector(refreshData), for: .valueChanged)
        tableView.refreshControl = refreshControl
        
        tableView.frame = view.bounds
        tableView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        view.addSubview(tableView)
    }
    
    private func setDataSource() {
        tableView.dataSource = self
        tableView.reloadData()
        refreshControl.endRefreshing()
    }
    
    // MARK: - UITableViewDataSource
    
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return data.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: cellIdentifier, for: indexPath)
        cell.textLabel?.text = data[indexPath.row]
        return cell
    }
    
    // MARK: - Refresh Control Action
    
    @objc private func refreshData() {
        DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
            self.refreshControl.endRefreshing()
            self.tableView.reloadData()
        }
    }
}

方案说明 #

1. 异步执行 beginRefreshing()：通过 DispatchQueue.main.async 将方法调用推迟到当前视图布局完成后执行，此时 RefreshControl 已处于屏幕可见范围内，不会触发警告。
2. 手动调整偏移量：部分场景下，即使调用 beginRefreshing()，tableView 不会自动滚动到显示刷新控件的位置，手动设置 contentOffset 可确保控件立即显示。
3. 请求仅执行一次：所有逻辑仍放在 viewDidLoad 中，该方法在视图生命周期内仅调用一次，满足需求。

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