Flutter通过Dio上传安卓相机XFile至.NET Core 6 C# REST服务遇415错误求最优方案

为什么出现HTTP 415错误 #

你的Flutter代码把图片字节直接放在JSON对象里，设置contentType: "image/jpeg"，但后端IFormFile期望的是multipart/form-data类型的请求，这种请求格式不匹配直接导致了415（不支持的媒体类型）错误。

不存本地的上传最佳实践 #

直接读取XFile的字节流构建multipart请求即可，完全不需要将图片保存到本地，具体实现如下：

Flutter端修改代码 #

用Dio的MultipartFile.fromBytes把图片字节包装成multipart文件，再发送请求：

Uint8List imageBytes = await image.readAsBytes();

// 包装图片字节为multipart文件
MultipartFile file = MultipartFile.fromBytes(
  imageBytes,
  filename: 'uploaded_photo.jpg', // 自定义文件名，后缀要匹配图片格式
  contentType: MediaType('image', 'jpeg'),
);

// 发送multipart请求
var response = await _client!.post(
  '你的上传地址/uploadimage',
  data: FormData.fromMap({
    'file': file,
  }),
);

• 无需手动设置contentType，Dio会自动为multipart请求生成正确的Content-Type: multipart/form-data; boundary=xxx
• 如果是PNG图片，把contentType改成MediaType('image', 'png')即可

.NET Core后端验证 #

你的后端代码本身没问题，但要确认两点：

• 控制器没有全局限制请求类型的特性
• 如果开启了CORS，确保允许multipart/form-data类型的请求

额外优化建议 #

• 加图片大小校验：Flutter端先判断imageBytes.length，超过阈值就提示用户；后端也可以在UploadImage方法里检查file.Length，避免接收过大文件
• 添加上传进度监听，提升用户体验：

var response = await _client!.post(
  '你的上传地址/uploadimage',
  data: FormData.fromMap({
    'file': file,
  }),
  onSendProgress: (int sent, int total) {
    double progress = sent / total;
    // 这里可以更新UI显示上传进度
  },
);

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