Flutter用http包注册用户时List<Map<String,String?>>转String报错如何解决

package:http的post方法如果直接传入Map<String, dynamic>类型的body参数，默认会将请求头设置为application/x-www-form-urlencoded，该编码格式仅支持单层字符串键值对，不支持嵌套的数组、Map等复杂类型，所以你传入的meta_data数组会触发类型转换报错。

方案1：发送JSON格式请求（后端支持JSON参数时推荐） #

• 首先导入dart:convert内置库
• 给请求添加Content-Type: application/json请求头
• 将整个body参数通过jsonEncode方法序列化为JSON字符串

import 'dart:convert';

// 原有逻辑省略
var response = await _httpClient.post(
  createCustomerUrl,
  headers: {'Content-Type': 'application/json'},
  body: jsonEncode({
    'email': customerModel.email,
    'first_name': customerModel.firstName,
    'last_name': customerModel.lastName,
    'password': customerModel.password,
    'username': customerModel.username,
    'meta_data': [
      {'key': 'birthdate', 'value': customerModel.birthdate},
    ],
  }),
);

该方案适配绝大多数REST接口场景，不需要后端做额外兼容。

方案2：后端仅支持form表单传参时的处理 #

如果后端强制要求使用application/x-www-form-urlencoded格式传参，需要手动将复杂类型的字段单独序列化为JSON字符串：

import 'dart:convert';

// 原有逻辑省略
var response = await _httpClient.post(
  createCustomerUrl,
  body: {
    'email': customerModel.email,
    'first_name': customerModel.firstName,
    'last_name': customerModel.lastName,
    'password': customerModel.password,
    'username': customerModel.username,
    'meta_data': jsonEncode([
      {'key': 'birthdate', 'value': customerModel.birthdate},
    ]),
  },
);

使用该方案需要后端对应对meta_data字段做JSON反序列化处理，才能正常读取嵌套数据。

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