Flutter使用Dio向REST API上传图片失败，Postman测试正常求解决

你的问题核心在于没有用FormData构建文件上传请求——Postman上传文件默认采用multipart/form-data格式，而你当前直接将文件对象放入普通键值对中，Dio会默认按application/json格式发送请求，后端无法识别文件数据。

修复步骤： #

1. 将图片转换为MultipartFile
   根据你获取图片的方式（比如image_picker返回的XFile或原生File），将图片转为Dio支持的MultipartFile类型。
2. 用FormData封装请求数据
   把普通字段（用户名、生日）和文件字段一起放入FormData对象，Dio会自动设置正确的请求头。
3. 替换Dio请求的data参数
   将原来的普通键值对数据替换为FormData对象。

修改后的代码示例： #

void editMyProfile({
  String? username,
  String? birthdate,
  dynamic photo, // 假设photo是File或XFile类型
}) async {
  emit(EditMyProfileLoadingState());
  try {
    // 1. 处理图片为MultipartFile
    MultipartFile? photoFile;
    if (photo != null) {
      if (photo is File) {
        photoFile = await MultipartFile.fromFile(
          photo.path,
          filename: photo.path.split('/').last, // 保留文件名方便后端识别
        );
      } else if (photo is XFile) {
        photoFile = MultipartFile.fromBytes(
          await photo.readAsBytes(),
          filename: photo.name,
        );
      }
    }

    // 2. 构建FormData
    final formData = FormData.fromMap({
      "name": username,
      "date_of_birth": birthdate,
      if (photoFile != null) "photo": photoFile, // 仅当有图片时添加字段
    });

    // 3. 发送请求
    await DioHelper.patchData(
      token: "Token $token",
      url: "$profileEndPoint$userId/",
      data: formData, // 替换为FormData对象
    );

    profileName = username!;
    profileBirthdate = birthdate!;
    showToast(
        text: "Profile updated successfully", state: ToastStates.success);
    emit(EditMyProfileSuccessState());
  } on DioError catch (e) {
    // 增加错误日志便于排查
    print("Dio错误信息：${e.message}");
    if (e.response != null) {
      print("后端返回错误：${e.response!.data}");
      print("请求URL：${e.requestOptions.uri}");
    }
    emit(EditMyProfileErrorState());
  }
}

额外注意事项： #

• 检查你的DioHelper.patchData封装方法，确保它没有对data做jsonEncode处理——如果传入的是FormData，Dio需要直接发送，不能转成JSON格式。
• 如果后端对文件名有格式或后缀要求，确保filename参数符合规则。
• 测试时可以打印formData内容，确认文件是否被正确添加到请求中。

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