UIPageViewController首个控制器imageView.layer.origin异常问题

核心问题原因 #

1. UIPageViewController预加载特性：首个TipViewController可能在页面未完全展示时就被初始化，viewDidAppear触发时视图布局流程尚未完成，导致pointerView.frame.origin仍为初始的(0,0)。
2. 直接修改frame的局限性：在Auto Layout启用的环境下，直接修改frame.origin会被后续布局更新覆盖，返回页面时布局系统重新计算位置，就会出现视觉显示与打印值不符的情况。
3. 视图生命周期时机错误：viewDidAppear并非获取最终布局的可靠时机，布局完成的回调是viewDidLayoutSubviews，在此之前视图的frame可能还处于临时状态。

具体修复方案 #

1. 切换为Auto Layout约束控制位置

放弃直接修改frame，给pointerView添加位置约束，通过修改约束的constant值调整位置，这是Auto Layout环境下的标准做法，可避免布局冲突。

示例代码：

// 在TipViewController的viewDidLoad中添加约束
private var pointerLeadingConstraint: NSLayoutConstraint!
private var pointerTopConstraint: NSLayoutConstraint!

override func viewDidLoad() {
    super.viewDidLoad()
    // 禁用pointerView的自动约束转换
    pointerView.translatesAutoresizingMaskIntoConstraints = false
    // 添加基础约束，初始位置根据storyboard/xib设置
    pointerLeadingConstraint = pointerView.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 0)
    pointerTopConstraint = pointerView.topAnchor.constraint(equalTo: view.topAnchor, constant: 0)
    NSLayoutConstraint.activate([pointerLeadingConstraint, pointerTopConstraint])
}

// 修改resetPointerView方法
private func resetPointerView() {
    if let origin = origin {
        pointerLeadingConstraint.constant = origin.x
        pointerTopConstraint.constant = origin.y
    }
    pointerView.alpha = 1
}

2. 延迟获取初始位置到viewDidLayoutSubviews

将初始位置的获取逻辑从viewDidAppear移到viewDidLayoutSubviews，确保布局完成后再读取正确的frame值：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    if origin == nil {
        print("Setting up origin for : \(data.name)")
        // 此处获取的是布局完成后的真实位置
        origin = CGPoint(x: pointerView.frame.origin.x, y: pointerView.frame.origin.y)
        origin?.x += data.pointerLocation.x
        origin?.y += data.pointerLocation.y
        // 初始设置位置
        resetPointerView()
    }
}

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // 仅在需要时重置位置，比如从其他页面返回
    resetPointerView()
}

3. 修正viewWillDisappear中的冗余操作

移除viewWillDisappear中的resetPointerView调用，此时视图即将消失，修改位置无意义，反而可能干扰后续布局恢复：

override func viewWillDisappear(_ animated: Bool) {
    print("     viewWillDisappear \(data.header)")
    super.viewWillDisappear(animated)
    pointerView.layer.removeAllAnimations()
    pointerView.alpha = 0
}

4. 检查UIPageViewController的控制器缓存逻辑

确保UIPageViewController对控制器的复用逻辑正确，避免首个控制器被多次初始化或重复布局。如果使用UIPageViewControllerDataSource的viewControllerBefore/After方法，要保证每次返回正确的实例，避免意外的视图状态重置。

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