Swift实现用户资料模块：如何将ImageView图片上传至POST API？

嘿，你现在要实现用户资料模块的头像上传功能对吧？看你当前的代码是把参数拼在GET请求的URL里，但头像这种二进制文件可不能这么传——GET请求长度有限，而且没法处理文件数据，得用multipart/form-data格式的POST请求才对。我给你一步步拆解怎么实现：

第一步：获取用户选择的头像（相机/图库） #

首先用iOS标准的UIImagePickerController让用户选择或拍摄头像，这里给你个简单的实现：

class ProfileViewController: UIViewController, UIImagePickerControllerDelegate, UINavigationControllerDelegate {
    
    // 点击头像按钮触发选择逻辑
    @IBAction func selectAvatarTapped(_ sender: UIButton) {
        let picker = UIImagePickerController()
        picker.delegate = self
        picker.allowsEditing = true // 允许用户裁剪头像到合适尺寸
        
        // 弹出选择菜单：相机/图库
        let alert = UIAlertController(title: "选择头像", message: nil, preferredStyle: .actionSheet)
        alert.addAction(UIAlertAction(title: "拍照", style: .default) { _ in
            picker.sourceType = .camera
            self.present(picker, animated: true)
        })
        alert.addAction(UIAlertAction(title: "从图库选择", style: .default) { _ in
            picker.sourceType = .photoLibrary
            self.present(picker, animated: true)
        })
        alert.addAction(UIAlertAction(title: "取消", style: .cancel))
        present(alert, 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
        }
        // 拿到头像后调用上传方法
        uploadAvatarToAPI(selectedImage)
    }
}

第二步：处理图片并构建上传请求 #

接下来把图片转成二进制数据，同时把你原来的文本参数（比如地址、姓名等）一起封装成符合要求的请求体，核心上传代码如下：

func uploadAvatarToAPI(_ avatar: UIImage) {
    // 1. 压缩图片（JPEG格式比PNG小，适合上传）
    guard let imageData = avatar.jpegData(compressionQuality: 0.8) else {
        print("图片转二进制数据失败")
        return
    }
    
    // 2. 设置API地址
    guard let apiUrl = URL(string: "http://xxxx.xx/UpdateEmp_test") else {
        print("API地址无效，请检查")
        return
    }
    
    // 3. 创建POST请求
    var request = URLRequest(url: apiUrl)
    request.httpMethod = "POST"
    // 生成边界字符串，用于分隔请求体里的不同参数
    let boundary = UUID().uuidString
    request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
    
    // 4. 构建请求体：拼接文本参数和图片数据
    var requestBody = Data()
    // 原来的文本参数都放在这里
    let textParameters: [String: String] = [
        "xx": xx, // 替换成你的实际变量
        "PermanentAddress": ADDrEss,
        "PermVillage": townCITY,
        "PermTaluk": taulkcode!,
        "PermDist": districtcode!,
        "PermPinCode": PINcode,
        "PermState": statecode!,
        "FatherName": FatherNaME
        // 其他需要传递的参数继续添加在这里
    ]
    
    // 把文本参数拼进请求体
    for (key, value) in textParameters {
        requestBody.append("--\(boundary)\r\n".data(using: .utf8)!)
        requestBody.append("Content-Disposition: form-data; name=\"\(key)\"\r\n\r\n".data(using: .utf8)!)
        requestBody.append("\(value)\r\n".data(using: .utf8)!)
    }
    
    // 把头像文件拼进请求体
    requestBody.append("--\(boundary)\r\n".data(using: .utf8)!)
    // 注意：这里的`name=\"avatar\"`要和后端API要求的文件参数名一致，比如后端可能叫`ProfileImage`
    requestBody.append("Content-Disposition: form-data; name=\"avatar\"; filename=\"user_avatar.jpg\"\r\n".data(using: .utf8)!)
    requestBody.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
    requestBody.append(imageData)
    requestBody.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)
    
    request.httpBody = requestBody
    
    // 5. 发送请求并处理响应
    let uploadTask = URLSession.shared.dataTask(with: request) { data, response, error in
        DispatchQueue.main.async {
            if let error = error {
                print("上传失败：\(error.localizedDescription)")
                // 这里可以给用户弹出错误提示，比如"头像上传失败，请重试"
                return
            }
            
            // 处理API返回的响应
            if let data = data, let responseStr = String(data: data, encoding: .utf8) {
                print("上传成功，API响应：\(responseStr)")
                // 这里可以更新UI，比如把上传后的头像显示在界面上
            }
        }
    }
    uploadTask.resume()
}

几个关键注意点 #

• 替换代码里的name=\"avatar\"为后端API要求的文件参数名，必须和后端约定一致，否则接口收不到图片。
• 图片压缩质量0.8可以根据需求调整，0是最小质量，1是原始质量，建议在0.6-0.9之间平衡清晰度和文件大小。
• 对于可选值（比如taulkcode!），最好用可选绑定避免崩溃，比如改成if let talukCode = taulkcode { textParameters["PermTaluk"] = talukCode }。
• 如果用的是SwiftUI，获取图片的方式需要用封装好的ImagePicker组件，但核心的上传逻辑和上面的代码一致。

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