Flutter调用注册接口传参正常，却提示fullName必填错误

你遇到的问题是Dio调用注册接口时返回fullName is required，但Postman正常调用无异常，大概率是请求格式或参数处理环节出了问题，以下是具体排查和解决方法：

1. 核对请求内容类型（Content-Type） #

Postman默认发送的是表单类型请求（application/x-www-form-urlencoded或multipart/form-data），而Dio默认会把Map类型的data序列化为JSON格式（application/json）。如果后端仅支持接收表单格式参数，就会识别不到fullName字段，从而返回必填错误。

解决方法： #

如果后端期望表单格式，将请求数据改为FormData：

Response response = await dio.post(Api.SIGN_UP, data: FormData.fromMap({
  'fullName': name,
  'email': email,
  'password': password,
}));

或者手动设置请求头为表单类型：

Response response = await dio.post(
  Api.SIGN_UP,
  data: {
    'fullName': name,
    'email': email,
    'password': password,
  },
  options: Options(headers: {'Content-Type': 'application/x-www-form-urlencoded'}),
);

2. 确认name参数的实际值 #

虽然参数标记为required，但调用时可能传入了空字符串。在方法内添加打印，确认参数是否有效：

Future<Map<String, dynamic>> signup({
    required String name,
    required String email,
    required String password,
  }) async {
    print('传入的name值：$name'); // 新增打印验证
    // ... 原有代码
  }

3. 检查Dio拦截器是否修改了请求数据 #

如果Dio实例添加了拦截器，可能在请求发送前修改了参数，导致fullName被过滤。检查Dio初始化代码，确认拦截器是否篡改了请求体：

final dio = Dio(Api.options);
// 排查是否有类似拦截器修改options.data
dio.interceptors.add(InterceptorsWrapper(
  onRequest: (options, handler) {
    // 确认此处没有删除或修改fullName字段
    return handler.next(options);
  },
));

4. 抓包对比Postman与Dio的请求 #

用Charles、Fiddler或Flutter DevTools抓包，对比两者的请求Body和Headers：

• 查看Dio发送的请求中是否包含fullName字段
• 核对Content-Type是否与Postman一致

通过以上步骤，基本可以定位并解决问题。

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