Flutter登录Django Rest Framework始终提示无效密码的排查与调试

一、调试定位错误的核心步骤 #

• 抓包查看实际请求：用Flutter DevTools的Network面板或Charles工具，直接看发送到/api/dj-rest-auth/login/的请求体，确认字段名、参数值是否和DRF要求一致。比如dj-rest-auth默认认username/email和password，别把字段写成user_name这类错名。
• 看Django详细日志：把Django的DEBUG设为True，控制台会输出Bad Request的具体原因——比如“字段username是必填项”“password字段格式错误”，比只看“Bad Request”有用10倍。
• 用Postman绕开Flutter测接口：直接在Postman里发相同参数的POST请求到登录接口。如果Postman能成功，问题肯定在Flutter的请求构造上；如果Postman也失败，那就是DRF后端配置的问题（比如自定义了序列化器但字段不匹配）。

二、Flutter try-catch错误捕获示例 #

Future<void> login(String account, String password) async {
  try {
    final uri = Uri.parse('https://你的域名/api/dj-rest-auth/login/');
    final response = await http.post(
      uri,
      headers: {'Content-Type': 'application/json'},
      // 这里用LoginRequestModel的话，就传model.toJson()
      body: jsonEncode({
        'email': account, // 用用户名登录就改成'username'，和DRF对应
        'password': password,
      }),
    );

    if (response.statusCode == 200) {
      final loginResp = LoginResponseModel.fromJson(jsonDecode(response.body));
      print('登录成功，token: ${loginResp.key}');
    } else {
      // 重点：打印响应体，DRF会返回具体错误提示
      print('登录失败，状态码: ${response.statusCode}');
      print('错误详情: ${response.body}');
      final errorMap = jsonDecode(response.body);
      throw Exception(errorMap.values.first?.join(', ') ?? '登录失败');
    }
  } catch (e) {
    print('捕获到错误: $e');
    // 这里可以给用户弹提示，比如FlutterToast.show(msg: e.toString())
  }
}

注意：一定要打印response.body，DRF返回的错误信息（比如{"password":["无效密码"]}）是定位问题的关键，比前端的模糊提示有用得多。

三、请求/响应模型排查要点 #

1. LoginRequestModel检查 #

• 字段key必须和DRF登录序列化器完全一致：dj-rest-auth默认接受username、email、password，别自己瞎改字段名。比如你的模型toJson方法写成这样就错了：

  // 错误示例：把email写成了mail，DRF识别不了
  Map<String, dynamic> toJson() => {'mail': email, 'pwd': password};
  

  DRF拿不到正确的账号参数，就会判定凭据无效，返回“无效密码”。
• 确认模型的参数没有被意外修改：比如是否在序列化前把密码做了不必要的加密——dj-rest-auth会自己处理密码验证，前端直接传明文即可（HTTPS保证传输安全）。

2. LoginResponseModel检查 #

• 匹配DRF的返回结构：dj-rest-auth登录成功默认返回{"key": "你的认证token"}，所以模型要对应：

  class LoginResponseModel {
    final String key;
  
    LoginResponseModel({required this.key});
  
    factory LoginResponseModel.fromJson(Map<String, dynamic> json) {
      return LoginResponseModel(key: json['key']);
    }
  }
  

  这个模型的问题不会导致登录失败，但会导致后续token解析出错，需要注意。

四、容易踩的其他坑 #

• 请求头没加Content-Type: application/json：DRF会把请求体当成表单数据，解析不出JSON参数，直接判定凭据无效。
• DRF端的配置问题：比如自定义了用户模型，但没在dj-rest-auth里配置对应的序列化器；或者禁用了email登录，但你前端传的是邮箱。
• Flutter端的参数编码问题：比如密码里有特殊字符，是否被正确JSON编码——用jsonEncode处理参数就能避免这个问题。

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