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
相关产品推荐
相关产品推荐

