Base64编码图片无法在iOS UIImageView中显示如何解决

你传入Data(base64Encoded:)的不是纯Base64字符串，而是完整的Data URL格式串，结构为data:<MIME类型>;base64,<实际Base64编码内容>。
iOS原生的Base64解码API仅接受纯编码内容段：

• 传入带前缀的完整串且加.ignoreUnknownCharacters参数时，系统会跳过前缀里的非Base64字符，但解码得到的二进制数据头部是损坏的，UIImage无法识别为有效图片，最终显示空白
• 移除.ignoreUnknownCharacters参数时，前缀包含的冒号、分号、逗号等非Base64合法字符会直接导致解码失败，返回nil
  网页端可正常渲染是因为浏览器内置了Data URL解析逻辑，会自动拆分前缀和编码内容再解码，不需要手动处理，因此会出现同串网页可用、iOS原生调用失败的现象。

先从字符串中拆分出纯Base64编码段，再执行解码，参考实现：

extension UIImage {
    convenience init?(base64DataURLString: String) {
        let pureBase64: String
        // 处理带Data URI前缀的情况
        if base64DataURLString.hasPrefix("data:image"),
           let base64Part = base64DataURLString.components(separatedBy: ",").last {
            pureBase64 = base64Part
        } else {
            // 兼容已经是纯Base64的场景
            pureBase64 = base64DataURLString
        }
        // 标准Base64解码，不需要加忽略未知字符参数
        guard let data = Data(base64Encoded: pureBase64) else {
            return nil
        }
        self.init(data: data)
    }
}

调用方式替换为：

// 原有错误写法
// let avatarData = Data(base64Encoded: avatarString!, options: .ignoreUnknownCharacters)
// cell.userAvatar.image = UIImage(data: avatarData!)
// 替换为
cell.userAvatar.image = UIImage(base64DataURLString: avatarString ?? "")

你的测试项目用这个写法替换后即可正常显示图片。

如果拆分后仍解码失败，可做两项检查：

• 确认前端上传的Base64没有做URL安全转义：如果字符串里出现-、_替换了标准Base64里的+、/，需要先替换回标准字符再解码
• 确认字符串没有被URL编码，比如存在%2F、%2B这类转义字符时，要先做URL解码再处理
• 大尺寸头像解码建议放到后台队列执行，避免阻塞主线程

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