iOS端Multipart文件上传Content-Type异常致500错误排查

核心问题定位 #

你遇到的iOS端500错误，结合两端请求头Content-Type不一致的现象，大概率是客户端请求构造存在平台兼容性问题，而非单纯服务器端问题。正常情况下，Multipart文件上传的请求头Content-Type应该是multipart/form-data; boundary=xxx（由http.MultipartRequest自动生成），你看到的application/json和text/html都不符合规范，说明请求构造过程中出现了异常。

具体修复步骤 #

1. 修复流类型转换代码

你的代码中stream.cast();这行没有赋值，导致流类型未正确转换，在iOS平台可能引发请求构造错误。修改为：

var stream = http.ByteStream(file.openRead());
stream = stream.cast<List<int>>(); // 显式转换为MultipartFile需要的Stream<List<int>>类型

2. 添加Accept请求头

服务器可能期望响应格式为JSON，显式设置Accept头可以避免服务器返回text/html类型的错误页面，同时规范请求预期：

final _header = <String, String>{
  'Authorization': 'Bearer ' + _prefs.token,
  'Accept': 'application/json', // 添加这一行
};

3. 确保文件相关参数正确

• 检查iOS端file是否存在、是否有读取权限，避免因文件无法读取导致请求体构造失败。
• 确认basename(file.path)在iOS端能正确获取文件名（可以打印出来验证），避免文件名异常引发服务器解析错误。

4. 不要手动设置Content-Type

http.MultipartRequest会自动生成正确的multipart/form-data类型头（包含自动生成的边界值），手动设置会覆盖这个正确的头，导致服务器无法解析请求体。

额外排查建议 #

如果修复后仍出现500错误，建议：

• 打印完整的请求信息（包括自动生成的Content-Type），确认请求格式是否符合multipart/form-data规范。
• 联系服务器运维人员查看500错误的具体日志，定位服务器端是否存在iOS平台特定的解析逻辑问题。

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