Swift中API返回图片无法在UIPageViewController中显示的问题

我帮你梳理一下代码里的几个关键问题，这些就是图片无法显示的核心原因：

1. Lazy属性controllers的异步API请求逻辑错误 #

你的controllers是lazy加载属性，但里面调用了异步的findIndividualProducts接口——API请求还没返回结果，controllers就已经初始化完成并返回空数组了。这直接导致UIPageViewController一开始没有任何可显示的视图控制器，自然看不到图片。

修复方案：
把controllers改成普通可变数组，在视图加载后再发起API请求，请求成功后再初始化控制器数组并更新PageViewController的显示：

class ProductPageVC: UIPageViewController {
    weak var pageViewControllerDelegate: ProductImagesPageViewControllerDelegate?
    // 改为普通可变数组
    var controllers: [UIViewController] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()
        automaticallyAdjustsScrollViewInsets = false
        dataSource = self
        delegate = self
        // 视图加载后再加载数据并配置控制器
        loadProductImagesAndConfigureControllers()
    }
    
    private func loadProductImagesAndConfigureControllers() {
        guard let productId = ProductServices.instance.selectedProduct?.id else { return }
        ProductServices.instance.findIndividualProducts(id: productId, completion: { [weak self] success in
            guard let self = self, success else { return }
            self.controllers.removeAll()
            let storyboard = UIStoryboard(name: "Main", bundle: nil)
            
            // 单个产品查询，直接取第一个详情即可
            guard let productDetail = ProductServices.instance.productDetails.first else { return }
            let imageCount = productDetail.productImg.count
            
            for imageIndex in 0..<imageCount {
                let imageVC = storyboard.instantiateViewController(withIdentifier: PRODUCT_IMAGE_VC) as! ImagesVC
                // 直接传递对应索引的图片URL
                imageVC.imageURL = productDetail.productImg[imageIndex]
                self.controllers.append(imageVC)
            }
            
            // 通知代理页面总数
            self.pageViewControllerDelegate?.setupPageController(numberOfPages: self.controllers.count)
            // 设置初始显示的控制器
            if !self.controllers.isEmpty {
                self.setViewControllers([self.controllers.first!], direction: .forward, animated: false, completion: nil)
                self.configureDisplaying(viewController: self.controllers.first!)
            }
        })
    }
    
    // 移除原来的lazy controllers和configureImg方法
    // ... 其他原有代码保持不变
}

2. ImagesVC的图片配置逻辑冗余且易出错 #

你在configureImage里遍历整个productDetails数组，这会导致如果数组有多个元素，最后一次遍历会覆盖之前的图片设置；而且索引的对应关系也不清晰。

修复方案：
给ImagesVC添加一个存储图片URL的属性，直接在初始化时传递：

class ImagesVC: UIViewController {
    @IBOutlet weak var imageView: UIImageView!
    var imageURL: String?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        configureImage()
    }
    
    private func configureImage() {
        guard let urlString = imageURL, let url = URL(string: urlString) else {
            imageView.image = UIImage(named: "image_not_found")
            return
        }
        imageView.sd_setImage(with: url)
    }
}

3. HeaderImageVC的代理协议未正确实现 #

你写了extension HeaderImageVC : ProductImagesPageViewController，但这应该是实现ProductImagesPageViewControllerDelegate协议，否则无法接收页面数量和页码变化的通知：

class HeaderImageVC: UIView {
    @IBOutlet weak var pageControl: UIPageControl!
    // 持有ProductPageVC的引用并设置自己为代理
    var productPageVC: ProductPageVC? {
        didSet {
            productPageVC?.pageViewControllerDelegate = self
        }
    }
}

extension HeaderImageVC : ProductImagesPageViewControllerDelegate {
    func setupPageController(numberOfPages: Int) {
        pageControl.numberOfPages = numberOfPages
    }
    
    func turnPageController(to index: Int) {
        pageControl.currentPage = index
    }
}

4. configureDisplaying方法简化 #

因为我们已经在初始化ImagesVC时传递了图片URL，这个方法只需要处理页码通知即可：

func configureDisplaying(viewController: UIViewController) {
    guard let imageVC = viewController as? ImagesVC, let index = controllers.firstIndex(of: imageVC) else { return }
    self.pageViewControllerDelegate?.turnPageController(to: index)
}

额外检查项 #

• 确认PRODUCT_IMAGE_VC这个Storyboard ID和你在Storyboard中给ImagesVC设置的ID完全一致。
• 检查productDetail.productImg中的URL是否为有效的HTTP/HTTPS链接，SDWebImage无法加载无效格式的链接。
• 异步闭包中记得用[weak self]避免循环引用，防止内存泄漏。

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