iOS Alamofire向Vapor传图片时filename缺失问题求助

错误原因：Vapor端解码自定义File结构体时，无法找到filename字段对应的值。核心问题是两端的参数传递不匹配——要么后端未按multipart文件上传规范处理，要么前端未传递filename字段。

方案1：Vapor端按标准multipart文件上传处理（推荐） #

Vapor内置UploadedFile类型专门处理文件上传，修改后端代码适配规范：

private func updatePicture(req: Request) async throws -> Response {
    // 解码上传的文件对象
    let uploadedFile = try req.content.decode(UploadedFile.self)
    
    // 校验文件名是否存在
    guard let filename = uploadedFile.filename else {
        throw Abort(.badRequest, reason: "文件名不能为空")
    }
    
    // 提取文件扩展名
    let fileExtension = filename.components(separatedBy: ".").last
    
    // 此处添加文件存储、更新用户头像记录等业务逻辑
    
    return .init(status: .accepted, headers: getDefaultHttpHeader(), body: .empty)
}

同时修正iOS端代码，确保表单字段名与后端匹配，补充数据校验和回调传递：

func uploadFiles(urlParams: [String], method: HTTPMethod, user: User, image: UIImage, completionHandler: @escaping ((Data?, HTTPURLResponse?, Error?)) -> Void) {
    guard let formattedUrl = URL(string: "\(url)/\(urlParams.joined(separator: "/"))") else {
        completionHandler((nil, nil, NSError(domain: "UploadError", code: -1, userInfo: [NSLocalizedDescriptionKey: "URL格式错误"])))
        return
    }
    
    let headers: HTTPHeaders = ["Authorization" : "Bearer \(user.token)"]
    
    // 校验图片转数据是否成功
    guard let imageData = image.jpegData(compressionQuality: 0.9) else {
        completionHandler((nil, nil, NSError(domain: "UploadError", code: -2, userInfo: [NSLocalizedDescriptionKey: "图片转二进制数据失败"])))
        return
    }
    
    let multiPart = MultipartFormData()
    // withName设为"file"，对应Vapor的UploadedFile默认字段名
    multiPart.append(imageData, withName: "file", fileName: "user_avatar.jpg", mimeType: "image/jpeg")

    // Alamofire 5+无需调用resume()，upload方法自动执行请求
    AF.upload(multipartFormData: multiPart, to: formattedUrl, method: .patch, headers: headers).response { response in
        print(response)
        // 正确传递回调参数
        completionHandler((response.data, response.response as? HTTPURLResponse, response.error))
    }
}

方案2：保留自定义File结构体，前端补充filename字段 #

如果需要继续使用自定义的File结构体，需在前端multipart表单中显式传递filename字段：

iOS端代码修改： #

func uploadFiles(urlParams: [String], method: HTTPMethod, user: User, image: UIImage, completionHandler: @escaping ((Data?, HTTPURLResponse?, Error?)) -> Void) {
    guard let formattedUrl = URL(string: "\(url)/\(urlParams.joined(separator: "/"))") else {
        completionHandler((nil, nil, NSError(domain: "UploadError", code: -1, userInfo: [NSLocalizedDescriptionKey: "URL格式错误"])))
        return
    }
    
    let headers: HTTPHeaders = ["Authorization" : "Bearer \(user.token)"]
    
    guard let imageData = image.jpegData(compressionQuality: 0.9),
          let filenameData = "user_avatar.jpg".data(using: .utf8) else {
        completionHandler((nil, nil, NSError(domain: "UploadError", code: -2, userInfo: [NSLocalizedDescriptionKey: "数据转换失败"])))
        return
    }
    
    let multiPart = MultipartFormData()
    // 添加filename字段，对应后端File结构体的filename属性
    multiPart.append(filenameData, withName: "filename")
    multiPart.append(imageData, withName: "data", fileName: "user_avatar.jpg", mimeType: "image/jpeg")

    AF.upload(multipartFormData: multiPart, to: formattedUrl, method: .patch, headers: headers).response { response in
        print(response)
        completionHandler((response.data, response.response as? HTTPURLResponse, response.error))
    }
}

Vapor端File结构体确保包含filename字段： #

struct File: Content {
    var filename: String
    var data: Data
    // 计算属性获取扩展名
    var `extension`: String? {
        filename.components(separatedBy: ".").last
    }
}

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