看起来你遇到了一个很典型的「Postman正常但代码调用失败」的问题，500错误通常是服务器处理请求时遇到了未预期的异常，我们可以结合你的代码从几个关键方向排查修复：

1. 检查参数传递位置是否与Postman一致 #

你的代码里把mode、title放在了请求Header中，但Postman调用时，这些参数大概率是作为FormData的表单字段传递的，而非Header。服务器可能期望从请求体（表单数据）中读取这些参数，找不到时就会抛出错误导致500。

修改建议：将mode、title移到FormData内，同时删除Header中对应的设置代码：

// 构建FormData时加入mode和title
formData = FormData.fromMap({
  "file": uploadList,
  "mode": mode,
  "title": title
});

// 删掉这两行Header设置
// dio.options.headers["mode"] = mode;
// dio.options.headers["title"] = title;

2. 确认多文件字段名是否匹配服务器要求 #

你用"file"作为多文件的字段名，但有些服务器（比如PHP后端）期望多文件上传时用"file[]"，或者需要逐个添加独立的"file"字段而非数组。

排查方法：打开Postman的「Code」功能（右上角</>按钮），选择Dart - Dio，对比Postman生成的FormData中文件字段名，和你的代码保持完全一致。如果服务器需要多个独立file字段，可修改FormData构建方式：

FormData formData = FormData();
// 逐个添加文件，而非数组
for (var file in medias) {
  formData.files.add(MapEntry(
    "file", 
    await MultipartFile.fromFile(file.path)
  ));
}

3. 避免手动设置multipart/form-data Content-Type #

当使用FormData时，Dio会自动设置正确的Content-Type（包含自动生成的boundary分隔符）。手动设置BaseOptions(contentType: 'multipart/form-data')会覆盖自动配置，导致请求头缺少boundary，服务器无法正确解析多部分表单数据，这是500错误的常见诱因。

修改建议：创建Dio时不要手动指定contentType：

// 直接使用默认BaseOptions，让Dio自动处理contentType
Dio dio = Dio();

4. 捕获服务器返回的详细错误信息 #

500错误的核心排查依据是服务器的具体报错内容，你目前只打印了异常对象，建议修改catch块打印更多细节：

catch (e) {
  if (e is DioException) {
    print("Dio错误详情: ${e.message}");
    if (e.response != null) {
      print("服务器状态码: ${e.response?.statusCode}");
      print("服务器错误内容: ${e.response?.data}");
    }
  } else {
    print("其他错误: $e");
  }
}

这些信息会直接告诉你服务器的问题（比如「找不到mode参数」「文件字段不匹配」等）。

5. 优化MultipartFile创建代码 #

你的代码里MultipartFile.fromFile(File(file.path).path)存在冗余，XFile的path本身就是文件绝对路径，直接使用即可：

uploadList.add(await MultipartFile.fromFile(file.path));

完整修改后的代码示例 #

Future<String?> CreatePost(String mode, String title, List<XFile> medias) async {
  String url = "http://192.168.1.196:5000/api/user/upload/status";
  try {
    var token = await SecureStorage().ReadToken();
    var auuid = await SecureStorage().ReadAuuid();

    // 构建包含所有参数的FormData
    FormData formData = FormData();
    // 添加文件
    for (var file in medias) {
      formData.files.add(MapEntry(
        "file", 
        await MultipartFile.fromFile(file.path)
      ));
    }
    // 添加表单参数
    formData.fields.add(MapEntry("mode", mode));
    formData.fields.add(MapEntry("title", title));

    // 初始化Dio，自动处理contentType
    Dio dio = Dio();
    // 设置身份验证Header
    dio.options.headers["auuid"] = auuid;
    dio.options.headers["token"] = token;

    print("请求URL: $url");
    var response = await dio.post(url, data: formData);

    print("响应状态码: ${response.statusCode}");
    if (response.statusCode == 200) {
      return response.statusCode.toString();
    } else {
      return null;
    }
  } on DioException catch (e) {
    // 打印详细错误日志
    print("Dio错误详情: ${e.message}");
    if (e.response != null) {
      print("服务器状态码: ${e.response!.statusCode}");
      print("服务器响应内容: ${e.response!.data}");
    }
    return null;
  } catch (e) {
    print("其他异常: $e");
    return null;
  }
}

如果以上修改仍未解决问题，建议用Postman导出cURL命令（右上角「Code」→ 选择cURL），同时给Dio添加日志拦截器打印完整请求内容，对比两者的差异：

dio.interceptors.add(LogInterceptor(
  requestBody: true,
  responseBody: true,
));

差异点就是问题的核心所在。

内容来源于stack exchange