Flutter iOS端上传大图片至Django REST API触发SocketException问题排查

嘿，我之前也碰到过类似的iOS端上传大文件到Django API的问题，结合你给出的错误信息（SocketException: OS Error: Connection reset by peer, errno = 54）和代码，给你分析下几个最可能的原因，以及对应的解决办法：

1. 服务器端的上传限制或超时设置 #

这是最常见的原因，虽然900KB看起来不大，但实际场景中很容易踩坑：

• 如果你的Django服务器前面搭了Nginx或者Apache这类反向代理，它们默认的请求体大小限制可能刚好卡到这个阈值。比如Nginx默认的client_max_body_size是1MB，上传900KB的图片加上表单里的name、description等字段，总请求体可能就超过了这个限制，服务器直接断开连接。
• 另外Django本身的上传超时设置如果过短，大文件还没传完就被服务器主动切断连接，也会触发这个错误。

解决办法：

• 如果你用Nginx，找到站点配置文件或者nginx.conf，把client_max_body_size调大，比如设成10MB：

  client_max_body_size 10M;
  

  修改完记得重启Nginx服务。
• 在Django的settings.py里调整上传相关的参数：

  # 允许在内存中处理的最大文件大小，超过的会自动存临时文件
  FILE_UPLOAD_MAX_MEMORY_SIZE = 10 * 1024 * 1024  # 10MB
  # 延长上传超时时间，比如设成5分钟
  FILE_UPLOAD_TIMEOUT = 300
  

2. iOS端的网络传输限制或ATS配置问题 #

iOS的网络机制和Android不太一样，有些隐性限制容易被忽略：

• 虽然你用的是HTTP协议，但如果ATS（App Transport Security）配置有问题，可能会对大文件的HTTP传输有拦截；
• 另外Flutter的http包在iOS上默认的请求超时时间可能比较短，大文件还没传完就超时，进而触发连接重置。

解决办法：

• 检查ios/Runner/Info.plist里的ATS配置，确保已经允许HTTP请求（因为你的API是HTTP的），添加或者确认这段配置：

  <key>NSAppTransportSecurity</key>
  <dict>
      <key>NSAllowsArbitraryLoads</key>
      <true/>
  </dict>
  

• 给你的MultipartRequest设置更长的超时时间，比如2分钟：

  request.timeout = const Duration(minutes: 2);
  

3. Flutter端文件流处理的兼容性问题 #

你代码里用了DelegatingStream.typed(image.openRead())来创建字节流，这个写法在Android上没问题，但在iOS上可能存在流处理的兼容性问题，导致传输中途流被中断，服务器收到不完整的数据后就重置了连接。

解决办法：
换一种方式创建MultipartFile，直接读取文件的字节数组，绕过流处理的潜在问题：

if (image != null) {
  // 直接读取文件为字节数组
  final fileBytes = await image.readAsBytes();
  request.files.add(http.MultipartFile.fromBytes(
    'image',
    fileBytes,
    filename: basename(image.path),
  ));
} else {
  request.fields['image'] = '';
}

这种方式在iOS上的稳定性会好很多。

额外的排查小技巧 #

• 去看Django的服务器日志，里面大概率会有对应的错误提示（比如请求体过大的报错），能直接帮你定位问题；
• 用Postman或者其他HTTP工具在iOS设备上测试上传同一张图片，看看能不能成功，这样就能快速判断是客户端还是服务器端的问题。

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