自定义PageViewController加载JSON数据到子控制器不显示问题排查

1. 子控制器生命周期与数据传递顺序不匹配 #

自定义PageViewController如果没正确处理子控制器的添加逻辑，可能导致ContentViewController的UI生命周期方法在数据传递前就执行完了，后续传数据也不会触发刷新。

• 排查：在ContentViewController的viewDidLoad、contentData的didSet里加打印日志，确认数据传递和UI初始化的先后顺序。
• 修复：
  必须先给子控制器赋值数据，再执行添加到父控制器的操作。如果手动管理子控制器，完整代码示例：

  let contentVC = ContentViewController()
  contentVC.contentData = loadedJSONData // 先传数据
  addChild(contentVC)
  contentVC.view.frame = view.bounds
  view.addSubview(contentVC.view)
  contentVC.didMove(toParent: self)
  

2. 异步数据加载后未触发UI刷新 #

如果JSON是异步加载的，自定义PageViewController初始化时就创建了ContentViewController，后续数据更新没有通知到子控制器。

• 排查：打印ContentViewController的contentData值，确认异步加载完成后是否重新赋值，以及赋值后有没有调用UI更新方法。
• 修复：
  给ContentViewController的数据源属性加观察者，自动触发UI刷新：

  var contentData: [String: Any]? {
      didSet {
          guard let validData = contentData else { return }
          updateReadingContent(with: validData) // 自定义的UI更新方法
      }
  }
  

  异步加载完成后，确保在主线程给子控制器重新赋值数据。

3. 子控制器视图布局异常 #

自定义PageViewController可能没正确设置子控制器的view尺寸，导致视图被隐藏或者frame为零。

• 排查：用Xcode视图调试器查看ContentViewController的view的frame、层级和隐藏状态。
• 修复：
  给子控制器的view添加AutoLayout约束，避免frame适配问题：

  contentVC.view.translatesAutoresizingMaskIntoConstraints = false
  NSLayoutConstraint.activate([
      contentVC.view.topAnchor.constraint(equalTo: view.topAnchor),
      contentVC.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
      contentVC.view.trailingAnchor.constraint(equalTo: view.trailingAnchor),
      contentVC.view.bottomAnchor.constraint(equalTo: view.bottomAnchor)
  ])
  

4. 自定义PageViewController的数据源方法逻辑错误 #

如果模仿UIPageViewController做分页逻辑，数据源方法返回的子控制器可能没有提前设置数据。

• 排查：检查viewControllerBeforeViewController、viewControllerAfterViewController这类方法，确认返回的ContentViewController是否已赋值对应JSON数据。
• 修复：
  在数据源方法里返回子控制器前，务必绑定对应数据：

  func pageViewController(_ pageVC: CustomPageViewController, viewControllerBefore currentVC: UIViewController) -> UIViewController? {
      guard let contentVC = currentVC as? ContentViewController, 
            let index = contentVCList.firstIndex(of: contentVC), 
            index > 0 else {
          return nil
      }
      let prevVC = contentVCList[index - 1]
      prevVC.contentData = jsonDataList[index - 1] // 提前绑定对应页的数据
      return prevVC
  }
  

5. UI更新未在主线程执行 #

JSON加载如果在后台线程完成，直接在后台给子控制器传数据并更新UI，会导致界面不刷新（硬编码因为在主线程所以正常）。

• 排查：检查JSON加载完成后的回调是否在主线程执行。
• 修复：
  所有UI相关操作强制在主线程执行：

  DispatchQueue.global().async {
      let loadedData = self.parseJSONFromFile()
      DispatchQueue.main.async {
          self.currentDisplayVC.contentData = loadedData
      }
  }
  

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