Flutter中Model解析响应转本地变量及类型不匹配错误解决

错误核心 #

你碰到的问题本质是类型不匹配：要么是把已经解析好的LoginModel实例直接当成Map<String, dynamic>来用，要么是转换方向搞反了（比如该把JSON Map转成LoginModel，却反过来操作）。

分步解决 #

1. 先理清正确流程 #

正常的网络请求→解析→转换逻辑应该是：

• 网络请求返回原始JSON字符串 → 转成Map<String, dynamic>
• 调用LoginModel.fromJson(map)把Map转成LoginModel实例
• 若需要把LoginModel转回Map，必须给模型类实现toJson()方法

2. 针对常见错误场景修正 #

场景1：直接把LoginModel实例赋值给Map变量

比如你可能在控制器里写了类似这样的错误代码：

Map<String, dynamic> userData = loginModel; // 错误：不能直接把模型转Map

修正方法：给LoginModel添加toJson()方法，通过方法完成转换：
在你的LoginModel类里补充：

Map<String, dynamic> toJson() {
  return {
    'id': id,
    'username': username,
    // 对应你的JSON字段，把模型里的每个属性转成Map的键值对
  };
}

然后在控制器里调用：

Map<String, dynamic> userData = loginModel.toJson(); // 正确：通过toJson转成Map

场景2：网络请求后解析流程混乱

如果你的网络请求类已经帮你把JSON转成了LoginModel，但你还试图把这个实例当作Map去解析，就会报错：

// 错误示例：apiResponse已经是LoginModel实例，却还调用fromJson
LoginModel model = LoginModel.fromJson(apiResponse);

修正方法：先确认网络请求类的返回值类型——如果它返回的是Map<String, dynamic>，再调用fromJson解析；如果已经返回LoginModel，直接用就行。

场景3：本地存储时类型处理错误

要是你想把LoginModel存到本地（比如SharedPreferences），不能直接存Map或模型实例，得先转成JSON字符串：

// 存储流程：LoginModel → Map → JSON字符串
String jsonStr = json.encode(loginModel.toJson());
await SharedPreferences.getInstance().setString('user', jsonStr);

// 读取流程：JSON字符串 → Map → LoginModel
String? savedJson = await SharedPreferences.getInstance().getString('user');
if(savedJson != null) {
  Map<String, dynamic> userMap = json.decode(savedJson);
  LoginModel user = LoginModel.fromJson(userMap);
}

3. 完整代码示例参考 #

假设你的登录接口JSON响应是：

{
  "code": 200,
  "msg": "登录成功",
  "data": {
    "id": 1,
    "username": "test_user"
  }
}

对应的LoginModel（包含fromJson和toJson）：

class LoginModel {
  int code;
  String msg;
  UserData data;

  LoginModel({required this.code, required this.msg, required this.data});

  // 从Map转成模型
  factory LoginModel.fromJson(Map<String, dynamic> json) {
    return LoginModel(
      code: json['code'],
      msg: json['msg'],
      data: UserData.fromJson(json['data']),
    );
  }

  // 从模型转成Map
  Map<String, dynamic> toJson() {
    return {
      'code': code,
      'msg': msg,
      'data': data.toJson(),
    };
  }
}

class UserData {
  int id;
  String username;

  UserData({required this.id, required this.username});

  factory UserData.fromJson(Map<String, dynamic> json) {
    return UserData(
      id: json['id'],
      username: json['username'],
    );
  }

  Map<String, dynamic> toJson() {
    return {
      'id': id,
      'username': username,
    };
  }
}

控制器里的正确处理逻辑：

class LoginController extends GetxController {
  Future<void> handleLogin(String username, String password) async {
    try {
      // 假设网络请求返回的是原始Map
      Map<String, dynamic> responseMap = await ApiService.login(username, password);
      // 转成LoginModel实例
      LoginModel loginResult = LoginModel.fromJson(responseMap);
      // 转成Map存到本地变量
      Map<String, dynamic> userInfoMap = loginResult.toJson();
      // 后续业务逻辑...
    } catch (e) {
      print(e); // 捕获并打印错误
    }
  }
}

关键提醒 #

• 时刻明确变量类型：Map<String, dynamic>是JSON解析后的原始类型，LoginModel是封装后的实体类，两者不能直接赋值，必须通过fromJson和toJson做转换。
• 核对网络请求库的配置：如果用了Dio这类库且配置了自动解析成Model，那请求返回的就是LoginModel实例，不要再重复调用fromJson。

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