使用Dio包发起HTTP请求时如何将函数参数作为请求体传递

可能的故障原因 #

• 参数值异常：调用login函数时传入的email、password存在空白字符（前后空格、换行符）、空值或格式不符合后端校验规则，硬编码参数为合法有效值，因此可以正常请求
• 语法错误：提供的代码片段中请求体的Map对象缺少右大括号，若实际代码存在该语法问题会直接导致运行异常
• 请求格式不匹配：若后端要求接收表单格式（application/x-www-form-urlencoded）的参数，Dio默认传JSON格式会导致参数解析失败，硬编码时如果本地Dio配置和正式代码有差异也会出现该现象

解决方案 #

1. 排查参数值合法性 #

在login函数开头添加日志打印，确认入参是否符合预期：

Future<void> login(String email, String password) async {
  // 新增日志，用[]包裹参数便于识别空白字符
  print('email: [$email], 长度: ${email.length}');
  print('password: [$password], 长度: ${password.length}');
  // 原有业务逻辑
}

如果打印结果显示参数前后有空白，或者值为null/空字符串，修正调用login函数处的传参逻辑即可。

2. 统一清洗参数 #

对入参做trim处理去除首尾空白，避免用户输入时带入多余空格：

response = await dio.post(url,
  data: {"email": email.trim(), "password": password.trim()});

3. 匹配后端要求的请求格式 #

如果后端要求表单格式传参，将请求体改为FormData类型：

import 'package:dio/dio.dart';

// 调用处修改
response = await dio.post(url,
  data: FormData.fromMap({"email": email.trim(), "password": password.trim()}));

4. 添加错误捕获定位问题 #

新增异常捕获逻辑，直接打印后端返回的错误详情，快速定位问题根源：

Future<void> login(String email, String password) async {
  String url = "https://phone-book-api.herokuapp.com/api/v1/signin";
  var dio = Dio();
  try {
    final response = await dio.post(url,
      data: {"email": email.trim(), "password": password.trim()});
    print(response.data);
  } on DioError catch(e) {
    // 打印错误响应内容和状态码
    print('请求失败，状态码：${e.response?.statusCode}');
    print('后端返回错误信息：${e.response?.data}');
  }
}

5. 修正语法问题 #

提供的代码片段中请求体Map缺少右大括号，修正后语法如下：

// 错误写法
data: {"email": email, "password": password);
// 正确写法
data: {"email": email, "password": password});

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