NSCache改为泛型后无法正常工作，无法加载缓存图片求助

我之前也踩过NSCache泛型使用的坑！结合你的问题描述和代码片段，咱们一步步排查解决：

核心问题分析 #

控制台只打印了缓存存入和主线程设置图片的日志，却没触发缓存读取的日志，大概率是这几个原因：

1. NSCache实例生命周期不对：如果imageCache是loadImageUsingURL方法里的局部变量，每次调用方法都会新建缓存，根本存不住数据！
2. 泛型类型太宽泛导致匹配失败：用NSCache<AnyObject, AnyObject>时，存取的类型可能因为桥接（比如String转NSString）出现隐性不匹配，导致取不出缓存。
3. 缓存检查逻辑有漏洞：比如key不一致、缓存检查的代码没走到，或者cell复用导致的逻辑覆盖。

具体解决方案 #

1. 把NSCache改成全局/单例（最关键！）

如果你的imageCache是局部变量，立刻改成全局或者单例，保证整个App里用的是同一个缓存实例：

// 全局缓存实例，用具体泛型类型替代AnyObject
let imageCache = NSCache<NSString, UIImage>()

class CustomImageView: UIImageView {
    var imageURLString: String?
    
    func loadImageUsingURL(urlString: String) {
        // 先检查当前视图的URL是否和请求的一致（解决cell复用问题）
        guard imageURLString == urlString else {
            imageURLString = urlString
            image = nil // 重置旧图片
            return
        }
        
        // 优先读取缓存
        if let cachedImage = imageCache.object(forKey: urlString as NSString) {
            print("Image From Cache Executed")
            self.image = cachedImage
            return
        }
        
        // 缓存不存在，发起网络请求
        guard let url = URL(string: urlString) else { return }
        
        URLSession.shared.dataTask(with: url) { [weak self] data, _, error in
            guard let self = self, let data = data, let newImage = UIImage(data: data) else {
                print("图片下载失败: \(error?.localizedDescription ?? "未知错误")")
                return
            }
            
            // 再次校验URL，避免cell复用导致的错误图片
            guard self.imageURLString == urlString else { return }
            
            DispatchQueue.main.async {
                print("Dispatch Main Queue CustomImageView")
                self.image = newImage
                print("After Image To Cache")
                // 存入缓存
                imageCache.setObject(newImage, forKey: urlString as NSString)
            }
        }.resume()
    }
}

2. 用具体泛型类型替代AnyObject

把NSCache<AnyObject, AnyObject>改成NSCache<NSString, UIImage>，这样：

• 避免了值类型（String）桥接成AnyObject时的隐性类型转换问题
• 存取缓存时不需要强制类型转换，减少出错概率

3. 优化缓存检查逻辑

• 每次加载图片前先校验imageURLString和请求的URL是否一致，解决UITableView/UICollectionView复用时的图片错乱问题
• 把缓存检查放在方法最开头，确保优先读取缓存

进阶：封装成单例缓存管理器（更健壮）

如果你的App多处用到图片缓存，建议封装成单例，方便统一管理：

class ImageCacheManager {
    // 单例实例
    static let shared = ImageCacheManager()
    
    // 私有缓存实例，外部无法直接修改
    private let cache = NSCache<NSString, UIImage>()
    
    // 私有初始化方法，禁止外部创建实例
    private init() {
        // 可以在这里设置缓存的最大容量、计数等
        cache.totalCostLimit = 100 * 1024 * 1024 // 100MB
        cache.countLimit = 200 // 最多存200张图片
    }
    
    // 存入缓存
    func cacheImage(_ image: UIImage, forKey key: String) {
        cache.setObject(image, forKey: key as NSString)
    }
    
    // 读取缓存
    func getCachedImage(forKey key: String) -> UIImage? {
        return cache.object(forKey: key as NSString)
    }
    
    // 清空缓存
    func clearCache() {
        cache.removeAllObjects()
    }
}

然后在CustomImageView里调用：

if let cachedImage = ImageCacheManager.shared.getCachedImage(forKey: urlString) {
    print("Image From Cache Executed")
    self.image = cachedImage
    return
}

// 下载完成后存入缓存
ImageCacheManager.shared.cacheImage(newImage, forKey: urlString)

验证方法 #

运行修改后的代码，先加载一张图片，然后再次调用loadImageUsingURL加载同一个URL，此时应该会打印"Image From Cache Executed"，说明缓存生效了。

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