Flutter使用MultipartFile上传文件后端接收为null该如何解决？

1. 确认后端接收字段匹配 #

你当前代码中上传文件的字段名为file_upload，需确保后端接口接收文件的参数名和该值完全一致，包括大小写也不能有差异，字段名不匹配是后端收到null的最常见原因。

2. 补全Content-Type配置 #

你当前注释了contentType配置，上传图片时建议明确指定对应媒体类型，需要先导入http_parser依赖，再修改对应配置：

// 先引入依赖
import 'package:http_parser/http_parser.dart';

// 其他代码不变，修改MultipartFile部分配置
request.files.add(await http.MultipartFile.fromBytes(
    'file_upload', file.readAsBytesSync(),
    contentType: MediaType('image', 'png'), // 对应png格式，其他格式按需修改即可
    filename: "ic_launcher.png"
));

3. 检查请求头是否存在冲突 #

你给请求加了自定义headers，注意不要在headers中手动设置Content-Type参数，MultipartRequest会自动生成带boundary标识的Content-Type，手动设置会覆盖boundary，导致后端无法解析上传的文件内容，直接返回null。
你可以打印headers变量确认是否包含Content-Type字段，如果有直接删除即可。

4. 校验文件有效性 #

可以先判断本地文件是否存在，再执行上传逻辑，避免空文件上传的问题：

if(await file.exists()){
  // 此处执行将文件添加到request的逻辑
}

5. 打印响应信息排查 #

你可以补充打印请求的响应状态码和完整返回内容，确认是否是后端参数校验失败、权限不足等问题导致的返回null：

var res = await request.send().timeout(Duration(seconds: 5));
print("响应状态码：${res.statusCode}");
final respStr = await res.stream.bytesToString();
print("接口完整返回内容：$respStr");

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