iOS 下UIScrollView按时间线从contentOffset.zero自动滚动到末端的自定义Timer方案失效

对照现有代码，无法实现预期效果的原因主要有4个：

• 动画逻辑冲突：每次0.1秒触发时都调用animated: true的滚动方法，前一次系统内置的滚动动画（默认持续约0.3秒）还没播放完成就被新的调用打断，最终表现就是视图纹丝不动，看起来完全没滚动
• 位移计算偏差：原代码中offsetX += ratingContainer.contentSize.width / CGFloat(totalTime) * 100的换算逻辑和0.1秒的定时器间隔完全不匹配，算出来的单步位移和实际需要的滚动进度对不上
• 可滚动范围计算错误：直接把contentSize.width当成终点，没有减去scrollView自身的bounds宽度——实际当contentOffset.x = contentSize.width时，视图已经偏移到内容末端以外，系统会自动把offset反弹回合法范围，根本到不了预期位置
• 定时器运行模式问题：默认创建的Timer只在default RunLoopMode下运行，一旦用户触摸拖动scrollView、或者页面其他滚动交互触发，Timer就会被暂停，整个滚动流程直接卡住

修正后逻辑完全匹配需求：固定contentSize宽度下，从zero位置按预设总时长匀速滚动到内容最末端

• 提前算好最大可滚动偏移值、单步滚动距离，避免每次回调重复计算
• 把定时器加到common RunLoopMode，避免交互时被暂停
• 用animated: false逐帧更新offset，避免动画互相打断
• 加边界判断，到达终点后自动停掉定时器，避免无效计算

对应修正代码：

// 类内属性定义
private weak var scrollTimer: Timer?
// 总滚动时长，单位：秒，比如设置5秒滚完就填5.0
private let autoScrollTotalTime: CGFloat = 5.0
// 每帧需要滚动的X距离
private var perStepOffsetX: CGFloat = 0
// scrollView可滚动的最大X偏移值
private var maxValidOffsetX: CGFloat = 0

fileprivate func startAutoScroll() {
    // 先销毁之前的定时器，避免重复创建导致多定时器并行滚动
    scrollTimer?.invalidate()
    
    // 提前计算核心参数
    maxValidOffsetX = ratingContainer.contentSize.width - ratingContainer.bounds.width
    // 如果内容宽度小于视图宽度，没有可滚动空间，直接返回
    guard maxValidOffsetX > 0 else { return }
    // 定时器每0.1秒触发一次，计算总触发次数下每步需要走的距离
    let totalStepCount = autoScrollTotalTime / 0.1
    perStepOffsetX = maxValidOffsetX / totalStepCount
    
    // 初始化滚动起点为zero
    ratingContainer.contentOffset = .zero
    
    // 构建定时器
    let timer = Timer(timeInterval: 0.1, repeats: true) { [weak self] timer in
        guard let self = self else {
            timer.invalidate()
            return
        }
        var currentX = self.ratingContainer.contentOffset.x
        currentX += self.perStepOffsetX
        
        // 到达最大可滚动范围时，固定终点位置，销毁定时器
        if currentX >= self.maxValidOffsetX {
            self.ratingContainer.contentOffset = CGPoint(x: self.maxValidOffsetX, y: 0)
            timer.invalidate()
            return
        }
        // 逐帧无动画更新offset，避免多动画冲突
        self.ratingContainer.setContentOffset(CGPoint(x: currentX, y: 0), animated: false)
    }
    
    // 将定时器加入common mode，避免滚动交互时被暂停
    RunLoop.main.add(timer, forMode: .common)
    scrollTimer = timer
    // 立即触发第一次回调，不用等待第一个0.1秒间隔
    timer.fire()
}

• 如果需要更顺滑的滚动效果，可以将定时器间隔调整为1/60（匹配屏幕刷新率），同步修改totalStepCount的计算逻辑即可
• 建议在scrollView的代理方法scrollViewWillBeginDragging中添加定时器销毁逻辑，当用户手动拖动时自动停止自动滚动，避免和用户操作冲突
• 因为场景是固定的contentSize，只要在视图布局完成、contentSize设置完成之后调用startAutoScroll方法，就不会出现参数计算错误的问题

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