Flutter HTTP Post请求首次返回错误响应问题排查

问题现象 #

使用http.dart库发起Post请求时，首次返回的对象列表中布尔属性（如示例中的param5）全部为默认false，不符合接口预期；但第二次请求能得到正确的true值。Swagger、Postman工具首次请求即可获取正确结果，仅Flutter端存在该异常。

首次响应示例：

[{"param1":"","param2":"value2","param3":"value3","param4":"value4","param5":false},{"param1":"","param2":"value2","param3":"value3","param4":"value4","param5":false}]

第二次响应示例：

[{"param1":"","param2":"value2","param3":"value3","param4":"value4","param5":true},{"param1":"","param2":"value2","param3":"value3","param4":"value4","param5":true}]

排查与解决方案 #

1. 修正模型类的JSON反序列化逻辑

布尔字段返回默认值最常见的原因是反序列化时未正确读取接口返回值，直接使用了模型类的默认参数。

错误示例：

class MyModel {
  final String param1;
  final String param2;
  final bool param5;

  // 构造函数给param5设了默认false，若解析失败会直接用该值
  MyModel({this.param1 = '', this.param2 = '', this.param5 = false});

  factory MyModel.fromJson(Map<String, dynamic> json) {
    return MyModel(
      param1: json['param1'] ?? '',
      param2: json['param2'] ?? '',
      // 未处理json['param5']为null的情况，直接赋值会导致默认false覆盖
      param5: json['param5'],
    );
  }
}

修正后：

class MyModel {
  final String param1;
  final String param2;
  final bool param5;

  // 强制要求传入所有参数，避免默认值干扰
  MyModel({required this.param1, required this.param2, required this.param5});

  factory MyModel.fromJson(Map<String, dynamic> json) {
    return MyModel(
      param1: json['param1'] ?? '',
      param2: json['param2'] ?? '',
      // 明确读取接口返回值，若为null再根据业务设置默认值
      param5: json['param5'] ?? false,
    );
  }
}

2. 禁用请求缓存

Flutter的http库默认不会缓存Post请求，但如果请求头包含缓存配置，或全局客户端存在缓存逻辑，可能导致首次请求返回旧数据。

添加禁用缓存的请求头：

var response = await http.post(
  Uri.parse('你的接口地址'),
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache, no-store, must-revalidate',
    'Pragma': 'no-cache',
    'Expires': '0',
  },
  body: jsonEncode(你的请求体),
);

3. 验证接口响应的Content-Type

若接口返回的Content-Type未标记为application/json，jsonDecode可能无法正确解析布尔值，导致字段为null，最终使用模型类的默认false。

打印响应头确认：

var response = await http.post(...);
print('Content-Type: ${response.headers['content-type']}');

若Content-Type异常，在请求头中明确要求返回JSON：

headers: {
  'Accept': 'application/json',
  'Content-Type': 'application/json',
},

4. 核对请求体完整性

首次请求可能因请求体参数构造错误，导致接口返回默认数据。对比Postman的请求体，确保Flutter发送的JSON参数完全一致：

var requestBody = {"你的参数键": "参数值"};
print('请求体: ${jsonEncode(requestBody)}');
var response = await http.post(
  Uri.parse('你的接口地址'),
  headers: {'Content-Type': 'application/json'},
  body: jsonEncode(requestBody),
);

5. 检查异步请求时机

若首次请求在未完成初始化时发起（比如initState中直接调用），可能存在异步竞态导致参数错误或响应处理异常。确保请求在页面初始化完成后发起：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    // 页面渲染完成后再发起请求
    fetchData();
  });
}

Future<void> fetchData() async {
  var response = await http.post(...);
  // 处理响应逻辑
}

内容的提问来源于stack exchange，提问作者Srujan Chowdary Panda