Flutter中form-data格式POST请求无法获取响应问题求助

问题场景 #

使用Flutter的http.MultipartRequest发送Form-Data格式的POST请求到登录接口，代码执行后无任何结果返回，但相同的URL和请求数据在Postman中可以正常获取响应。

Postman验证截图：

相关代码：

var map = new Map<String, String>();
final url = Uri.parse(globals.ServerDomain + '/login');
Map<String, String> requestBody = <String, String>{
  'username': '80889099',
  'password': '123456789abcde'
};
var request = http.MultipartRequest('POST', url)
  ..fields.addAll(requestBody);
var response = await request.send();
final respStr = await response.stream.bytesToString();
print(respStr);

排查与解决方案 #

1. 添加异常捕获，定位错误原因 #

当前代码未处理任何异常，请求可能因网络错误、超时、服务器拒绝等原因抛出异常但未被捕获，导致无输出。修改代码添加try-catch块：

try {
  final url = Uri.parse(globals.ServerDomain + '/login');
  Map<String, String> requestBody = <String, String>{
    'username': '80889099',
    'password': '123456789abcde'
  };
  var request = http.MultipartRequest('POST', url)
    ..fields.addAll(requestBody);
  
  // 添加超时设置，避免无限等待
  var response = await request.send().timeout(const Duration(seconds: 10));
  final respStr = await response.stream.bytesToString();
  print('响应状态码：${response.statusCode}');
  print('响应内容：$respStr');
} catch (e) {
  print('请求异常：$e');
}

通过捕获异常和打印状态码，能快速定位是网络问题、超时还是服务器返回错误。

2. 匹配Postman的请求头 #

Postman发送请求时会自动添加一些默认请求头（比如User-Agent、Accept等），部分服务器会校验这些头信息。可以在MultipartRequest中手动添加匹配Postman的请求头：

var request = http.MultipartRequest('POST', url)
  ..fields.addAll(requestBody)
  ..headers.addAll({
    'User-Agent': 'PostmanRuntime/7.32.3', // 替换为Postman实际的User-Agent
    'Accept': '*/*',
    // 复制Postman中其他必要的请求头
  });

可以在Postman的「Headers」标签页查看所有请求头，将必要的信息复制到代码中。

3. 检查服务器对Form-Data的解析要求 #

部分服务器要求Form-Data字段必须包含特定的Content-Disposition参数，或者对字段编码有特殊要求。可以尝试手动构建字段或用MultipartFile模拟文本字段：

// 手动添加字段
request.fields['username'] = '80889099';
request.fields['password'] = '123456789abcde';

// 或者用MultipartFile模拟文本字段（针对严格解析的服务器）
request.files.add(
  await http.MultipartFile.fromString(
    'username',
    '80889099',
    contentType: MediaType('text', 'plain'),
  ),
);
request.files.add(
  await http.MultipartFile.fromString(
    'password',
    '123456789abcde',
    contentType: MediaType('text', 'plain'),
  ),
);

4. 确认网络权限 #

确保Flutter项目已配置网络访问权限：

• Android：在AndroidManifest.xml中添加

  <uses-permission android:name="android.permission.INTERNET" />
  

• iOS：如果服务器使用HTTP而非HTTPS，在Info.plist中添加ATS配置

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

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