Flutter发送阿拉伯文件名至API时被加密存储，请求技术支援

核心问题 #

Postman能正常传递阿拉伯语文件名，但Flutter端上传时出现乱码/加密名称，本质是Flutter的MultipartFile默认对非ASCII文件名的编码处理和Postman不一致，导致API端解析异常。

解决方案步骤 #

• 显式指定文件名的UTF-8编码
  在创建MultipartFile时，不要直接传递字符串文件名，而是通过UTF-8编码处理后再构造，确保API端能正确解析。

  错误示例（易触发编码异常）：

  MultipartFile.fromFile(
    filePath,
    filename: "أسم_الملف.pdf", // 直接传阿拉伯语字符串可能编码异常
  );
  

  修正后的代码：

  import 'dart:convert';
  import 'package:http/http.dart' as http;
  
  // 构造MultipartFile时显式处理文件名编码
  final file = await MultipartFile.fromFile(
    filePath,
    filename: utf8.decode(utf8.encode("أسم_الملف.pdf")), // 确保用UTF-8编码传递
    contentType: MediaType('application', 'pdf'), // 显式指定类型，避免默认推断的编码问题
  );
  
  // 构造请求并发送
  var request = http.MultipartRequest('POST', Uri.parse(apiUrl));
  request.files.add(file);
  var response = await request.send();
  

• 避免手动覆盖请求头编码设置
  Flutter的MultipartRequest会自动生成包含正确边界和charset=utf-8的Content-Type头，不要手动设置该头，否则可能破坏编码逻辑：

  // 错误做法：不要手动设置以下内容
  // request.headers['Content-Type'] = 'multipart/form-data';
  

• 验证文件名编码正确性
  发送前可打印编码后的文件名，确认传递过程无异常：

  String arabicFilename = "أسم_الملف.pdf";
  print(utf8.encode(arabicFilename)); // 输出UTF-8字节数组，确认非空且格式正确
  print(utf8.decode(utf8.encode(arabicFilename))); // 确认解码后与原文件名一致
  

额外排查点 #

如果以上方法无效，检查：

• 本地文件系统的文件名是否为正确的阿拉伯语格式（排除本地文件编码问题）
• API端是否有特殊的文件名解析规则（但Postman能正常工作，所以大概率是Flutter端问题）

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