如何使用Flutter mime包通过魔数检测MIME类型解决MP4识别异常问题

根因说明 #

默认package:mime的lookupMimeType方法仅通过文件后缀推断类型，不会读取文件二进制头的魔数做校验，因此遇到后缀与实际文件内容不匹配的文件时，返回结果会和后端按二进制内容检测的结果不一致。

具体实现步骤 #

• 读取目标文件的前20个字节（该长度足够覆盖绝大多数媒体文件的魔数校验区间）
• 将读取到的字节数组传入lookupMimeType的headerBytes参数，触发魔数校验逻辑

代码示例 #

import 'dart:io';
import 'package:mime/mime.dart';

Future<String?> getMimeTypeWithMagicCheck(File targetFile) async {
  RandomAccessFile accessFile = await targetFile.open();
  int fileLength = await accessFile.length();
  // 读取文件头字节，长度不足20则读取全部内容
  List<int> headerBytes = accessFile.readSync(fileLength >= 20 ? 20 : fileLength);
  await accessFile.close();
  // 传入headerBytes启用魔数检测，文件后缀作为兜底规则
  return lookupMimeType(targetFile.path, headerBytes: headerBytes);
}

• 若启用魔数检测后，合法MP4文件仍返回application/octet-stream，说明该文件的魔数不在mime包的默认映射库中，可手动添加自定义魔数匹配规则：

import 'package:mime/mime.dart';

void registerCustomMp4Rule() {
  final customResolver = MimeTypeResolver();
  // 可根据你手上文件的实际头字节调整匹配规则，以下为标准mp4 ftyp块的常见魔数示例
  customResolver.addMagicNumber(
    [0x00, 0x00, 0x00, 0x18, 0x66, 0x74, 0x79, 0x70, 0x6D, 0x70, 0x34, 0x32],
    'video/mp4',
    mask: List.filled(12, 0xFF), // 对应位置字节完全匹配
  );
}

上传适配 #

调用上传接口时，需将检测得到的MIME类型手动指定给上传文件的contentType参数，避免上传库自动推导错误。以dio的MultipartFile配置为例：

import 'package:http_parser/http_parser.dart';

String? detectedMimeType = await getMimeTypeWithMagicCheck(videoFile);
final uploadFile = await MultipartFile.fromFile(
  videoFile.path,
  contentType: MediaType.parse(detectedMimeType ?? 'video/mp4'),
);

异常处理 #

如果经魔数检测确认文件确实返回application/octet-stream，说明该文件为非标准MP4文件，仅后缀被修改为.mp4，可选择两种方案处理：

1. 前端先对文件做转码处理，生成标准MP4文件后再上传
2. 和后端协商，添加该类文件的接收白名单，绕过MIME类型校验

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