CollectionView无法显示图片问题求助（基于Unsplash API）

控制台能打印JSON但CollectionView无内容，核心是数据未正确传递到UI层或UI未触发刷新，按以下步骤排查：

1. 确认数据更新时触发了UI刷新 #

网络请求是异步操作，获取数据后必须通知CollectionView刷新：

• 若用ViewModel+Combine：确保ViewController订阅了@Published属性，收到数据后调用collectionView.reloadData()
• 若用闭包回调：在请求完成的闭包（必须切到主线程）里更新数据源数组并执行刷新

  func fetchPhotos() {
      URLSession.shared.dataTask(with: request) { data, _, error in
          guard let data = data else { return }
          do {
              let photos = try JSONDecoder().decode([Photo].self, from: data)
              // 必须在主线程更新UI相关数据
              DispatchQueue.main.async {
                  self.viewModel.photos = photos
                  self.collectionView.reloadData()
              }
          } catch { print(error) }
      }.resume()
  }
  

2. 检查CollectionView数据源方法正确性 #

• 确认numberOfItemsInSection返回数据源数组的真实长度，而非固定值：

  func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
      return viewModel.photos.count // 避免返回0或错误数值
  }
  

• 检查cellForItemAt是否正确取数并设置图片：

  func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
      let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "PhotoCell", for: indexPath) as! PhotoCell
      let photo = viewModel.photos[indexPath.item]
      // 确保用Unsplash返回的有效图片URL（如regular/small尺寸）
      cell.photoImageView.kf.setImage(with: URL(string: photo.urls.regular))
      return cell
  }
  

3. 验证CollectionView基础配置 #

• 确认已注册自定义Cell：

  collectionView.register(PhotoCell.self, forCellWithReuseIdentifier: "PhotoCell")
  

• 检查布局设置：确保UICollectionViewFlowLayout的itemSize不为0，或Cell的Autolayout约束完整（contentView需有明确的宽高约束）

4. 确认数据模型解析无遗漏 #

虽然控制台能打印JSON，但需验证模型属性与JSON字段完全匹配：

struct Photo: Codable {
    let id: String
    let urls: PhotoURLs // 嵌套结构体必须正确解析
}

struct PhotoURLs: Codable {
    let regular: String // 字段名需与Unsplash返回的JSON完全一致
    let small: String
}

可在ViewModel赋值后打印viewModel.photos.count，确认数组不为空。

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