Flutter解析JSON时state_code空值校验报错的解决方案

问题根源很明确：当JSON里的state_code为"FL"时，你的枚举映射表找不到对应值，返回null，但你用了!强制解包空值，直接触发「Null check operator used on a null value」错误。下面给几种实用的解决办法：

1. 给枚举新增「未知项」（推荐） #

扩展枚举，增加一个专门处理未匹配值的选项，比如unknown，同时重构映射逻辑，让找不到值时默认返回这个选项：

// 修改枚举
enum StateCode { mn, ny, unknown }

// 重构映射工具类，用方法替代直接取map
class StateCodeValues {
  static const _map = {
    "MN": StateCode.mn,
    "NY": StateCode.ny,
  };

  static StateCode fromString(String code) {
    return _map[code] ?? StateCode.unknown;
  }
}

// 解析时调用方法，无需加!
stateCode: StateCodeValues.fromString(json["state_code"] as String)

这种方式既避免空值，又能明确标记未定义的州码，后续还能针对unknown做针对性处理（比如日志记录、用户提示）。

2. 允许StateCode为空 #

如果业务逻辑允许stateCode为null，可以把变量类型改成StateCode?，去掉强制解包的!：

// 实体类字段定义
final StateCode? stateCode;

// 解析时直接赋值
stateCode: stateCodeValues.map[json["state_code"] as String]

这种方式最简单，但后续使用stateCode时需要处理null场景，比如用stateCode?.xxx或者if (stateCode != null)做判断。

3. 抛出自定义异常（严格校验场景） #

如果不允许出现未定义的州码，希望快速定位非法数据，可以提前检查并抛出异常：

final stateCodeStr = json["state_code"] as String;
final stateCode = stateCodeValues.map[stateCodeStr];
if (stateCode == null) {
  throw FormatException("不支持的州码：$stateCodeStr");
}
// 后续直接使用stateCode，无需加!

这种方式适合对数据校验要求高的场景，能及时拦截非法数据。

4. 临时指定默认值 #

如果只是临时兼容未定义的州码，可以用??运算符指定默认值：

stateCode: stateCodeValues.map[json["state_code"] as String] ?? StateCode.mn

但不推荐长期使用，因为默认值可能不符合业务逻辑，新增未知项的方案更清晰可控。

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