跨平台开发 / 系统课时

处理缺失字段和可空字段

处理缺失字段和可空字段

服务端返回的数据并不总是完整可靠,字段缺失、返回 null 或不同版本接口并存都是 Flutter 应用中常见的问题。本篇将学习如何设计可空字段和默认值,避免 JSON 解析阶段出现运行时异常。

学习目标

  • 理解 Dart 空安全与 JSON 缺失字段的关系
  • 掌握可空类型和默认值的选择方法
  • 能够设计更稳定的数据模型解析逻辑

识别接口中的不确定字段

JSON 中可能出现以下情况:

json
{
  "id": 1001,
  "name": "Alice",
  "avatar": null
}

也可能直接缺少字段:

json
{
  "id": 1001,
  "name": "Alice"
}

如果 Dart 模型声明字段必须存在,解析时访问不存在的键可能导致异常。因此需要根据业务含义决定字段是否允许为空。

使用可空类型表示可选数据

Dart 空安全通过 ? 表示字段可以为 null。例如用户头像不是核心信息,可以定义为可空字段:

dart
class User {
  final int id;
  final String name;
  final String? avatar;

  User({
    required this.id,
    required this.name,
    this.avatar,
  });

  factory User.fromJson(Map<String, dynamic> json) {
    return User(
      id: json['id'] as int,
      name: json['name'] as String,
      avatar: json['avatar'] as String?,
    );
  }
}

预期结果

text
包含 avatar 时保存字符串值,缺少 avatar 或返回 null 时 User.avatar 为 null。

为字段设计合理默认值

并不是所有缺失字段都应该变成 null。有些字段具有明确业务默认值,例如未读取数量可以默认为 0:

dart
class MessageInfo {
  final int unreadCount;

  MessageInfo({required this.unreadCount});

  factory MessageInfo.fromJson(Map<String, dynamic> json) {
    return MessageInfo(
      unreadCount: json['unreadCount'] as int? ?? 0,
    );
  }
}

预期结果

text
JSON 包含 unreadCount 时使用接口值,字段缺失或为 null 时使用 0。

选择默认值时需要考虑业务语义。如果 null 表示“未知”,就不要强制替换成空字符串或 0,否则会丢失真实状态。

处理嵌套字段为空的情况

嵌套对象也可能为空,例如:

json
{
  "id": 1001,
  "profile": null
}

对应模型需要允许整个对象为空:

dart
class User {
  final int id;
  final Profile? profile;

  User({required this.id, this.profile});

  factory User.fromJson(Map<String, dynamic> json) {
    return User(
      id: json['id'] as int,
      profile: json['profile'] == null
          ? null
          : Profile.fromJson(json['profile']),
    );
  }
}

预期结果

text
profile 字段为空时不会调用 Profile.fromJson,User 对象仍然可以正常创建。

可空字段设计原则

模型设计时可以根据字段重要程度选择策略:

字段类型 推荐处理方式
必须存在的业务主键 使用非空类型并校验
展示信息如头像、简介 使用可空类型
明确业务默认值的数据 使用默认值
服务端可能删除的字段 使用可空类型

合理处理缺失字段,可以让应用面对接口升级、灰度发布和历史数据时更加稳定。数据模型的目标不是完全复制 JSON,而是建立适合应用使用的数据边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理缺失字段和可空字段

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通