跨平台开发 / 系统课时
处理缺失字段和可空字段
处理缺失字段和可空字段
服务端返回的数据并不总是完整可靠,字段缺失、返回 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,而是建立适合应用使用的数据边界。
按自己的节奏,确认真正理解。