Flutter中Dio Post请求修改密码返回400错误，求解决方案

在Swagger中可正常运行的修改密码接口，使用Flutter的Dio调用时始终返回Http status error 400，大概率是请求格式或参数不匹配导致，以下是具体排查和解决步骤：

1. 修正Dio请求数据的处理方式 #

你的API层代码中手动使用了jsonEncode处理请求体，而Dio默认会自动将Map类型的data参数序列化为JSON格式，手动编码会导致请求体被双重序列化（变成JSON字符串而非JSON对象），后端无法正确解析。

修改后的API层代码：

Future changePassword(int id, String password) async {
  try {
    var prefs = await SharedPreferences.getInstance();
    final response = await dio.post(
      'http://192.168.1.108:2308/api/Account/ChangePassword',
      // 直接传Map，Dio会自动转为JSON
      data: {
        "id": id, // 若后端要求字符串类型，改为id.toString()
        "password": password
      },
      options: Options(headers: {
        HttpHeaders.acceptHeader: '*/*',
        // 无需手动设置Content-Type，Dio默认会自动添加application/json
      }),
    );
    if (response.statusCode != 200) {
      debugPrint('响应状态码：${response.statusCode}');
    }
    prefs.remove('password');
    return response;
  } catch (e) {
    // 捕获Dio错误，打印详细信息便于排查
    if (e is DioException) {
      debugPrint('请求错误信息：${e.message}');
      debugPrint('错误状态码：${e.response?.statusCode}');
      debugPrint('后端返回的错误详情：${e.response?.data}');
    } else {
      debugPrint(e.toString());
    }
    rethrow; // 重新抛出错误，让上层调用逻辑处理
  }
}

2. 核对接口参数与Swagger一致 #

400错误常见原因是参数不匹配，需对比Swagger中的接口定义：

• 检查参数名是否一致：比如后端是否要求newPassword而非你传的password
• 检查参数类型：id在后端是数字类型还是字符串类型，确保传参类型匹配
• 检查必填字段：修改密码接口通常需要旧密码（如oldPassword），若Swagger中包含该参数，需在请求体中添加对应字段（页面调用时传入oldPwdController.text）

3. 完善错误捕获与调试 #

原代码的catch块仅打印错误的字符串形式，无法获取后端返回的具体错误提示。修改后通过DioException可以拿到响应的详细数据，比如后端提示“参数缺失”或“格式错误”，能快速定位问题。

4. 页面调用层的注意事项 #

确保传入的usrId不为空，且参数类型与API层定义一致：

// 页面调用时确保usrId有效
if (usrId != null) {
  await api.changePassword(usrId, newPwdController.text);
} else {
  // 处理用户ID为空的情况
}

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