使用Alamofire和Swift上传PNG至Imgur时部分图片出现白底问题

你使用的上传代码： #

let url = URL(string: "https://api.imgur.com/3/upload")!
private var headers: [String: String] {
    ["X-Token": "[mytokenhere]", "Authorization": "Client-ID [myidhere]"]
}

Alamofire.upload(multipartFormData: { multipart in
    if let data = UIImagePNGRepresentation(image.image) {
         multipart.append(data, withName: "image", fileName: "image.png", mimeType: "image/png")
    }
}, to: url, headers: headers, encodingCompletion: { result in
    //convert result image from result here
})

图片对比： #

• 本地原图（正常显示透明背景）：
  
• 上传前示例图（已出现白底）：
  
• 上传后示例图（白底保留）：
  

问题原因： #

1. UIImage转换丢失透明通道：UIImagePNGRepresentation处理图片时，若UIImage在加载过程中丢失了透明通道信息（比如从Asset加载时默认用了模板渲染模式，或图片被系统自动处理过），转换后的Data就没有透明属性，上传后自然会被填充白底。
2. Imgur的自动格式优化：Imgur会对部分上传图片做兼容性优化，如果检测到图片透明通道不完整、格式存在歧义，或服务器判断图片更适合转成JPG，就会自动填充白色背景并转换格式——哪怕你指定了PNG的文件名和MIME类型。

解决办法： #

• 直接读取原始文件Data：不要通过UIImage中转，直接从本地文件路径读取图片的原始Data，完整保留PNG的透明通道和格式信息。
• 修正UIImage加载方式：如果必须用UIImage处理，加载图片时要保留原始渲染模式，比如从Asset加载时设置image = UIImage(named: "xxx")?.withRenderingMode(.alwaysOriginal)，避免系统自动添加背景。
• 指定Imgur上传参数：在multipart表单中添加type=file参数，明确告知服务器按原始文件格式处理，减少自动转换的概率。

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