Flutter用Dio FormData传视频至S3无法修改默认Content-Type

首先明确核心问题：当使用FormData上传文件时，请求的全局Content-Type必然是multipart/form-data，这是HTTP多部分表单上传的协议要求，Dio会自动生成该头部并添加boundary，你手动在Options里设置video/mp4会被自动覆盖，这是正常行为，不需要修改。

你真正需要关注的是文件本身的Content-Type元数据，也就是传给S3的文件类型标识，以下是针对不同上传场景的解决方案：

场景1：通过FormData上传（后端代理或S3表单上传） #

这种情况下，MultipartFile的contentType设置是正确的，但需要额外确保S3能识别到该元数据：

1. 保留MultipartFile的contentType设置，确保类型正确
2. 如果是直接上传到S3的表单接口，需要在FormData中额外添加Content-Type字段，明确告知S3文件类型
3. 示例代码：

final formData = FormData.fromMap({
  // S3必填字段：存储的文件路径/名称
  'key': 'videos/${DateTime.now().millisecondsSinceEpoch}.mp4',
  // 明确指定文件的Content-Type元数据
  'Content-Type': 'video/mp4',
  'file': await MultipartFile.fromFile(
    file.path,
    filename: fileName,
    contentType: MediaType.parse('video/mp4'),
  ),
  // 补充S3表单上传所需的其他字段：policy、signature、AWSAccessKeyId等
});

final response = await dio.put(endpoint, data: formData);

场景2：使用S3预签名URL直接上传 #

如果是通过预签名URL上传，不需要使用FormData，直接上传文件二进制数据即可，此时可以直接设置请求的Content-Type：

// 读取文件二进制
final fileBytes = await File(file.path).readAsBytes();

final response = await dio.put(
  yourPresignedUrl,
  data: fileBytes,
  options: Options(
    contentType: 'video/mp4',
    headers: {
      'Content-Length': fileBytes.length.toString(),
    },
  ),
);

为什么之前的方法无效？ #

• 当data为FormData时，Dio会强制将请求的Content-Type设为multipart/form-data，手动设置的Options.contentType会被忽略，这符合HTTP协议规范
• S3未识别到文件类型，大概率是因为缺少明确的元数据字段（如上述的Content-Type表单字段），而非请求的全局Content-Type问题

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