使用http multipart上传图片返回成功但实际未上传该如何解决

绝大多数该场景的问题根源是手动设置了不带boundary的multipart/form-data请求头，http库的MultipartRequest会自动生成包含随机边界标识的正确Content-Type，手动覆盖请求头后服务器无法拆分请求中的字段和文件内容，直接跳过文件处理逻辑返回响应，因此出现秒回但文件未上传的现象。

具体修复步骤 #

• 移除手动设置的Content-Type请求头：不要主动给MultipartRequest添加Content-Type属性，底层会自动拼接带boundary的合法请求头
• 新增响应状态校验：拿到请求返回的StreamedResponse后首先判断状态码是否为2xx，非成功状态直接做异常处理，避免误判请求结果
• 完整读取响应流：必须等待响应流全部接收完成后再做数据解析，不能将请求发送完成等价于上传成功
• 优化参数校验逻辑：确认field参数和后端约定的上传文件字段名完全一致，文件后缀判断逻辑兼容大小写、无后缀等异常场景

修正后代码示例 #

import 'dart:convert';
import 'package:http/http.dart' as http;
import 'package:http_parser/http_parser.dart';

Future<UpdatedUserDataModel> updateUserData(
      {String accessToken, String field, String value}) async {
    String params = '?access_token=$accessToken';
    String url = AppStrings.apiBase + AppStrings.updateUserData + params;

    http.MultipartRequest request = http.MultipartRequest(
      'POST',
      Uri.parse(url),
    );
    request.fields['api_key'] = AppStrings.apiKey;
    // 移除了手动加Content-Type的错误逻辑
    String fileSuffix = value.split('.').last.toLowerCase();
    request.files.add(
      await http.MultipartFile.fromPath(
        field,
        value,
        filename: 'cover_image',
        contentType: MediaType('image', fileSuffix),
      ),
    );

    final response = await request.send();
    
    // 状态码校验
    if (response.statusCode < 200 || response.statusCode >= 300) {
      throw Exception("上传失败，错误状态码：${response.statusCode}");
    }
    
    // 完整读取响应内容
    final responseStr = await response.stream.bytesToString();
    return UpdatedUserDataModel.fromJson(jsonDecode(responseStr));
  }

补充排查方案 #

如果完成上述修改后问题仍存在，可以通过抓包工具查看完整请求体，确认文件二进制内容是否正常携带，同时校验后端是否存在文件大小、格式限制，或者权限校验逻辑导致的文件未保存问题。

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