Swift UICollectionView自动轮播首次滚动右偏16点异常问题

• 实现间隔5秒自动滚动的UICollectionView轮播组件时，首次触发自动滚动没有正常滑动到下一张，而是向右偏移16pt到屏幕边缘
• 首次滚动完成后，后续所有自动滚动行为均正常
• 异常效果参考：

核心实现代码如下：

// ViewController.swift
class ViewController: UIViewController {
        
    private var topChannelsCollectionView = TopChannelsCollectionView()
        
    @IBOutlet var dots: UIPageControl!
    
    var timer = Timer()
    var counter = 0
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        dots.numberOfPages = TopChannelModel.fetchChannels().count
        dots.currentPage = 0
        
        DispatchQueue.main.async { [self] in
            timer = Timer.scheduledTimer(timeInterval: 5.0, target: self, selector: #selector(automaticScrollImage), userInfo: nil, repeats: true)
        }
        
        view.addSubview(topChannelsCollectionView)
       
        topChannelsCollectionView.leadingAnchor.constraint(equalTo: view.leadingAnchor).isActive = true
        topChannelsCollectionView.trailingAnchor.constraint(equalTo: view.trailingAnchor).isActive = true
        topChannelsCollectionView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 6).isActive = true
        topChannelsCollectionView.heightAnchor.constraint(equalToConstant: 200).isActive = true
        
        topChannelsCollectionView.setContentFor(channels: TopChannelModel.fetchChannels())
        
        // MARK: - add constraints for dots
        dots.leadingAnchor.constraint(equalTo: view.leadingAnchor).isActive = true
        dots.trailingAnchor.constraint(equalTo: view.trailingAnchor).isActive = true
        dots.topAnchor.constraint(equalTo: topChannelsCollectionView.bottomAnchor, constant: 10).isActive = true
        dots.widthAnchor.constraint(equalToConstant: 200).isActive = true
        
        dots.translatesAutoresizingMaskIntoConstraints = false
    }
    
    @objc func automaticScrollImage() {
        
        if counter < dots.numberOfPages {
            let index = IndexPath.init(item: counter, section: 0)
            self.topChannelsCollectionView.scrollToItem(at: index, at: .centeredHorizontally, animated: true)
            dots.currentPage = counter
            counter += 1
        } else {
            counter = 0
            let index = IndexPath.init(item: counter, section: 0)
            self.topChannelsCollectionView.scrollToItem(at: index, at: .centeredHorizontally, animated: false)
            dots.currentPage = counter
            counter = 1
        }
        
    }

}

// TopChannelsCollectionView.swift
class TopChannelsCollectionView: UICollectionView, UICollectionViewDelegate, UICollectionViewDataSource {

    private var channels: [TopChannelModel] = []

    init() {
        let layout = UICollectionViewFlowLayout()
        layout.scrollDirection = .horizontal
        super.init(frame: .zero, collectionViewLayout: layout)
        
        backgroundColor = #colorLiteral(red: 0.113761507, green: 0.1048973277, blue: 0.150441885, alpha: 1)
        delegate = self
        dataSource = self
        register(TopChannelsCollectionViewCell.self, forCellWithReuseIdentifier: TopChannelsCollectionViewCell.reuseId)
        
        translatesAutoresizingMaskIntoConstraints = false
        
        layout.minimumLineSpacing = Constants.galleryMinimumLineSpacing
        contentInset = UIEdgeInsets(top: 0, left: Constants.leftDistanceToView, bottom: 0, right: Constants.rightDistanceToView)
        
        showsHorizontalScrollIndicator = false
        showsVerticalScrollIndicator = false
        isPagingEnabled = true
    }
}

偏移问题是两个配置/时机错误叠加导致的：

1. 初始偏移未校准：自定义集合视图中设置的左侧contentInset值刚好为16pt，但由于UICollectionView通过AutoLayout布局，viewDidLoad阶段视图尚未完成布局、frame和contentSize都未计算完成，系统不会自动将contentOffset调整到适配contentInset的正确初始位置，默认contentOffset.x = 0比正确展示首图的位置向右偏移了16pt。
2. 定时器启动时机错误+初始索引值错误：
   • viewDidLoad阶段就启动5秒间隔定时器，此时集合视图还未完成布局，第一次滚动触发时会和系统的布局刷新、contentInset调整操作冲突
   • 初始counter值设为0，第一次触发滚动时会尝试滚动到第0个item（也就是首屏本来就展示的第一张图），而非预期的第二张图，进一步放大了偏移异常

首次滚动完成后，contentOffset被系统校准到正确值，后续滚动就不会再出现偏移问题。

按以下步骤修改即可解决：

1. 修正初始计数值：初始状态默认展示第0张图，将counter初始值改为1，保证第一次触发滚动时直接跳转至第1张图，避免重复滚动第0张

var counter = 1

2. 延后定时器启动时机，移除viewDidLoad里的定时器启动代码，等视图完成布局后再启动定时器，同时主动校准初始contentOffset：

// 新增标记位，保证仅首次布局时执行初始化操作
private var isFirstLayoutCompleted = false

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    guard !isFirstLayoutCompleted else { return }
    isFirstLayoutCompleted = true
    
    // 校准初始偏移量，适配contentInset
    topChannelsCollectionView.contentOffset = CGPoint(
        x: -topChannelsCollectionView.contentInset.left,
        y: 0
    )
    
    // 布局完成后再启动自动滚动定时器
    timer = Timer.scheduledTimer(
        timeInterval: 5.0,
        target: self,
        selector: #selector(automaticScrollImage),
        userInfo: nil,
        repeats: true
    )
}

3. 新增定时器销毁逻辑，避免页面消失后定时器仍运行导致内存泄漏：

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    timer.invalidate()
}

额外提示：如果是整页滑动轮播效果，建议实现UICollectionViewDelegateFlowLayout的sizeForItemAt方法，将cell尺寸设置为和集合视图bounds等宽等高，同时将minimumLineSpacing设为0，避免开启isPagingEnabled时因边距导致的分页位置计算误差。

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