Swift 4开发iOS应用：图片上传至服务器问题求助

嘿，我来帮你搞定这个iOS图片上传的问题！你遇到的base64解码后出黑图的情况我之前也碰到过，大概率是编码过程中图片数据处理出了小问题，另外其实直接用二进制上传比base64更高效还能避免这类编码坑，下面给你详细的解决方案：

出现黑图通常有这几个原因：

• 图片转Data时用错了格式（比如用UIImagePNGRepresentation处理JPG图）
• 压缩参数设置不合理导致数据损坏
• 传输过程中base64字符串被截断或篡改

给你一套正确的base64编码/解码流程：

// 编码：UIImage转base64字符串
guard let image = UIImage(named: "your-image") else { return }
// 优先用jpeg格式，压缩质量0.8兼顾体积和清晰度
guard let imageData = image.jpegData(compressionQuality: 0.8) else {
    print("图片转Data失败")
    return
}
let base64String = imageData.base64EncodedString(options: .lineLength64Characters)

// 解码：base64字符串还原UIImage
guard let restoredData = Data(base64Encoded: base64String) else {
    print("base64解码失败")
    return
}
let restoredImage = UIImage(data: restoredData)

⚠️ 还要提醒后端同事：存储base64字符串时要确保完整，别因为数据库字段长度不够截断内容。

base64会让数据体积膨胀30%左右，直接传二进制不仅效率更高，还能彻底避免编码解码的坑。下面是完整的代码示例，包含图片选择和上传逻辑：

1. 实现UIImagePickerController代理（选择图片） #

class ViewController: UIViewController, UIImagePickerControllerDelegate, UINavigationControllerDelegate {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // 添加一个触发选择图片的按钮
        let pickBtn = UIButton(type: .system)
        pickBtn.setTitle("选择图片上传", for: .normal)
        pickBtn.addTarget(self, action: #selector(pickImageAction), for: .touchUpInside)
        pickBtn.frame = CGRect(x: 50, y: 200, width: 300, height: 50)
        view.addSubview(pickBtn)
    }
    
    @objc func pickImageAction() {
        let picker = UIImagePickerController()
        picker.delegate = self
        picker.sourceType = .photoLibrary // 选相册，要相机的话改成.camera
        picker.allowsEditing = true // 允许裁剪编辑图片
        present(picker, animated: true)
    }
    
    // 选择图片完成后的回调
    func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
        picker.dismiss(animated: true)
        
        // 获取编辑后的图片（没有编辑就取原图）
        guard let selectedImage = info[.editedImage] as? UIImage ?? info[.originalImage] as? UIImage else {
            print("未选中有效图片")
            return
        }
        
        // 调用上传方法
        uploadImage(image: selectedImage)
    }
    
    func imagePickerControllerDidCancel(_ picker: UIImagePickerController) {
        picker.dismiss(animated: true)
    }
}

2. 实现图片上传的网络请求 #

extension ViewController {
    func uploadImage(image: UIImage) {
        guard let imageData = image.jpegData(compressionQuality: 0.8) else {
            print("图片转二进制失败")
            return
        }
        
        // 替换成你的服务器上传接口地址
        guard let url = URL(string: "https://your-server-api/upload-image") else {
            print("无效的服务器地址")
            return
        }
        
        var request = URLRequest(url: url)
        request.httpMethod = "POST"
        
        // 生成MultipartFormData的分隔符
        let boundary = UUID().uuidString
        request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
        
        // 组装请求体
        var body = Data()
        // 这里的"image"是后端约定的接收参数名，要和后端对齐
        body.append("--\(boundary)\r\n".data(using: .utf8)!)
        body.append("Content-Disposition: form-data; name=\"image\"; filename=\"uploaded.jpg\"\r\n".data(using: .utf8)!)
        body.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
        body.append(imageData)
        body.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)
        
        request.httpBody = body
        
        // 发起网络请求
        let task = URLSession.shared.dataTask(with: request) { data, response, error in
            DispatchQueue.main.async {
                if let error = error {
                    print("上传失败：\(error.localizedDescription)")
                    return
                }
                
                // 校验服务器响应状态
                guard let httpResp = response as? HTTPURLResponse, (200...299).contains(httpResp.statusCode) else {
                    print("服务器响应异常")
                    return
                }
                
                if let data = data, let respStr = String(data: data, encoding: .utf8) {
                    print("上传成功！服务器返回：\(respStr)")
                    // 这里可以处理后端返回的图片ID等数据
                }
            }
        }
        task.resume()
    }
}

• 权限配置：如果用相机拍照，要在Info.plist中添加NSCameraUsageDescription和NSPhotoLibraryUsageDescription字段，说明权限用途
• 后端配合：要确保后端能正确解析MultipartFormData格式的请求，比如PHP用$_FILES['image']，Java Spring用MultipartFile接收
• 压缩调整：jpegData(compressionQuality:)的参数可以在0-1之间调整，数值越高图片质量越好但体积越大

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