自定义UIImage扩展便利初始化方法失效：UIImage(urlString: String?)无报错但无法正常工作

你的代码看起来没报错，但无法正常工作的核心原因是异步网络请求和同步初始化的冲突，我来给你拆解清楚：

为什么当前代码失效？ #

URLSession.shared.dataTask(with:completionHandler:)是异步执行的——调用.resume()后，代码会立刻跳转到self.init(data: imageData)这一行，而此时网络请求还在后台跑，imageData还是初始的空Data，自然初始化不出有效的UIImage。

推荐修复方案 #

网络请求天生是异步的，我们应该用异步的方式来处理结果，以下两种是最常用的正确写法：

1. 闭包回调方式（兼容所有iOS版本）

把便利初始化改成类方法，用闭包返回加载后的图片：

extension UIImage {
    static func load(from urlString: String?, completion: @escaping (UIImage?) -> Void) {
        // 先校验URL合法性
        guard let urlString = urlString, let url = URL(string: urlString) else {
            completion(nil)
            return
        }
        
        URLSession.shared.dataTask(with: url) { data, response, error in
            // 处理错误
            if let error = error {
                print("图片加载失败: \(error.localizedDescription)")
                completion(nil)
                return
            }
            
            // 校验响应状态码
            guard let httpResponse = response as? HTTPURLResponse, (200...299).contains(httpResponse.statusCode) else {
                print("无效的图片响应状态码")
                completion(nil)
                return
            }
            
            // 解析图片并回调（注意回到主线程更新UI）
            guard let data = data, let image = UIImage(data: data) else {
                print("图片数据为空或无效")
                completion(nil)
                return
            }
            
            DispatchQueue.main.async {
                completion(image)
            }
        }.resume()
    }
}

使用示例：

// 在需要加载图片的地方调用
UIImage.load(from: "https://your-image-url.com/test.jpg") { image in
    if let loadedImage = image {
        self.yourImageView.image = loadedImage
    }
}

2. Async/Await方式（iOS 15+ 更简洁）

如果你的项目支持iOS 15及以上，用Swift的异步等待语法会更优雅：

extension UIImage {
    static func load(from urlString: String?) async -> UIImage? {
        guard let urlString = urlString, let url = URL(string: urlString) else {
            return nil
        }
        
        do {
            // 异步等待网络请求结果
            let (data, response) = try await URLSession.shared.data(from: url)
            
            // 校验响应状态
            guard let httpResponse = response as? HTTPURLResponse, (200...299).contains(httpResponse.statusCode) else {
                print("无效的图片响应状态码")
                return nil
            }
            
            return UIImage(data: data)
        } catch {
            print("图片加载失败: \(error.localizedDescription)")
            return nil
        }
    }
}

使用示例（需要在异步上下文调用，比如Task）：

Task {
    if let loadedImage = await UIImage.load(from: "https://your-image-url.com/test.jpg") {
        // 回到主线程更新UI
        DispatchQueue.main.async {
            self.yourImageView.image = loadedImage
        }
    }
}

不推荐的方案：同步网络请求 #

如果你非要用类似初始化的同步写法，也可以用信号量阻塞线程等待请求完成，但强烈不建议在主线程调用，会导致UI卡顿甚至卡死：

extension UIImage {
    convenience init?(urlString: String?) {
        guard let urlString = urlString, let url = URL(string: urlString) else {
            return nil
        }
        
        var imageData: Data?
        let semaphore = DispatchSemaphore(value: 0)
        
        let task = URLSession.shared.dataTask(with: url) { data, response, error in
            defer { semaphore.signal() } // 请求结束后发送信号
            if let error = error {
                print("图片加载失败: \(error.localizedDescription)")
                return
            }
            
            guard let httpResponse = response as? HTTPURLResponse, (200...299).contains(httpResponse.statusCode) else {
                print("无效的图片响应状态码")
                return
            }
            
            imageData = data
        }
        
        task.resume()
        semaphore.wait() // 阻塞线程等待请求完成
        
        guard let data = imageData else {
            return nil
        }
        self.init(data: data)
    }
}

调用时必须放在后台线程：

DispatchQueue.global().async {
    let image = UIImage(urlString: "https://your-image-url.com/test.jpg")
    DispatchQueue.main.async {
        self.yourImageView.image = image
    }
}

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