You need to enable JavaScript to run this app. Flutter使用Dio发起POST请求上传图片,服务端接收文件损坏无法打开
优惠活动
大模型
产品
解决方案
定价
更多

Flutter使用Dio发起POST请求上传图片,服务端接收文件损坏无法打开

文件上传后服务端存储损坏无法打开的问题定位

问题现象

  • 上传流程可正常触发全链路执行,服务端能成功接收请求并生成对应存储文件,但文件无法被正常打开
  • 本地源文件大小为196KB,服务端实际存储的接收文件仅191KB,存在明确的内容损坏/缺失
  • 开发初期使用Dart原生http库实现上传逻辑时,可复现完全相同的故障表现

现有实现代码

Flutter客户端当前上传逻辑

void getFile() async {
    FilePickerResult result = await FilePicker.platform.pickFiles(
      type: FileType.custom,
      allowedExtensions: ['jpg', 'mp4', 'mov', 'png', 'jpeg'],
      allowMultiple: false,
    );
    if (result != null) {
      PlatformFile file = result.files.first;
      var dio = new Dio();
      dio.options.baseUrl = uri;
      FormData formData = new FormData.fromMap({
        "filename":
            await MultipartFile.fromFile(file.path, filename: file.name),
        // "data": MultipartFile.fromBytes(file.bytes, filename: file.name),
      });
      var response = await dio.post(
        "/upload/${file.path.split('/').last}",
        data: formData,
      );
      if (response.statusCode == 200) {
        print(response);
        // final player = json.decode(response.body);
        // checkState(player);
      } else {
        throw Exception('Failed to upload a file');
      }
    } else {
      // User canceled the picker
    }
  }

Node.js服务端当前接收逻辑

service.post("/upload/:filename", function (req, res) {
  console.log(req);
  var filename = path.basename(req.params.filename);
  filename = path.resolve("app/media", filename.replace(/\s/g, ""));
  var dst = fs.createWriteStream(filename);
  req.pipe(dst);
  dst.on("drain", function () {
    console.log("Yukleniyor... ", new Date());
    req.resume();
  });
  req.on("end", function () {
    console.log("Tamamlandi... " + filename);
    res.end(JSON.stringify(MyPlayer));
  });
});

可正常工作的Web端参照实现

const selectedFile = document.getElementById("media").files[0];
  $.ajax({
    type: "POST",
    url: target + "/upload/" + selectedFile.name,
    data: selectedFile,
    processData: false,
    contentType: false,
  }).done(function (data) {
    document.getElementById("label").innerHTML = data;
  });

根因分析

客户端与服务端的上传协议完全错配,是文件损坏的核心诱因:

  • Node.js服务端当前的接收逻辑为直接将请求原始流完整写入存储文件,预期接收的是Web端那种直接将File对象作为请求体的原始二进制流,全程未对请求内容做任何格式解析
  • Flutter客户端当前采用FormData + MultipartFile封装,发送的是标准multipart/form-data格式请求,整个请求体除文件本身的二进制内容外,还包含multipart分隔边界、表单字段名文本、结尾边界符等非文件内容
  • 服务端未搭载multipart格式解析能力,直接将带冗余包装的完整请求体写入存储文件,导致文件首尾混杂了文本格式的分隔标记,自然无法被正常打开;文件大小相差的5KB,正好对应这些multipart包装内容的总大小
  • 此前使用Dart原生http库复现相同故障,本质是当时的实现同样默认封装了multipart格式请求体,与服务端的接收预期不匹配

修复路径

  • 路径1:对齐现有服务端逻辑,修改Flutter端上传实现,移除FormData封装,直接将文件的原始二进制流作为请求体发送,手动为请求设置对应文件类型的MIME值作为Content-Type,完全复刻Web端的发送效果
  • 路径2:若要保留Flutter端的multipart表单上传逻辑,需要修改Node.js服务端接收逻辑,引入multipart解析中间件,从表单请求中提取对应字段的纯文件二进制内容写入存储文件,不得再直接将整个请求流pipe到存储文件中

内容的提问来源于stack exchange,提问作者İbrahim Mert Gül

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 05:06:03