Flutter空安全报错：Null不是ApiResponse<Map<String,dynamic>>的子类型

核心问题分析 #

这个报错本质是代码期望一个非空的ApiResponse<Map<String, dynamic>>对象，但实际得到了null——Flutter空安全特性要求所有变量默认不可为空，除非显式用?标记为可空类型。

常见修改点（针对servers_http.dart和stars_provider.dart） #

1. 修正网络请求方法的返回值处理 #

在servers_http.dart中，网络请求方法可能存在分支未返回值（默认返回null），但方法声明为非空类型的情况。

错误示例：

ApiResponse<Map<String, dynamic>> fetchData() async {
  final response = await http.get(Uri.parse(url));
  if (response.statusCode == 200) {
    return ApiResponse(data: json.decode(response.body));
  }
  // 无返回值，默认返回null，与声明的非空类型冲突
}

修改方案二选一：

• 标记方法返回值为可空：

ApiResponse<Map<String, dynamic>>? fetchData() async {
  final response = await http.get(Uri.parse(url));
  if (response.statusCode == 200) {
    return ApiResponse(data: json.decode(response.body));
  }
  return null; // 现在合法
}

• 确保所有分支返回非空ApiResponse：

ApiResponse<Map<String, dynamic>> fetchData() async {
  final response = await http.get(Uri.parse(url));
  if (response.statusCode == 200) {
    return ApiResponse(data: json.decode(response.body), error: null);
  }
  return ApiResponse(data: null, error: '请求失败，状态码：${response.statusCode}');
}

2. 修正Provider中的数据接收逻辑 #

在stars_provider.dart中，若调用了可空返回值的网络方法，需对应处理null赋值场景。

错误示例：

class StarsProvider extends ChangeNotifier {
  ApiResponse<Map<String, dynamic>> _data;

  Future<void> loadData() async {
    _data = await ServerHttp.fetchData(); // 若fetchData返回null，直接报错
    notifyListeners();
  }
}

修改方案二选一：

• 标记存储变量为可空：

class StarsProvider extends ChangeNotifier {
  ApiResponse<Map<String, dynamic>>? _data; // 标记为可空类型

  Future<void> loadData() async {
    _data = await ServerHttp.fetchData();
    notifyListeners();
  }
}

• 使用空合并运算符提供默认值：

class StarsProvider extends ChangeNotifier {
  ApiResponse<Map<String, dynamic>> _data = ApiResponse(data: {}, error: null); // 初始化默认值

  Future<void> loadData() async {
    _data = await ServerHttp.fetchData() ?? ApiResponse(data: {}, error: '请求返回空数据');
    notifyListeners();
  }
}

3. 检查ApiResponse类的空安全适配 #

确保ApiResponse类的字段符合空安全规则：

class ApiResponse<T> {
  final T? data; // 允许data为空则加?
  final String? error; // 允许error为空则加?

  ApiResponse({this.data, this.error});
}

额外排查技巧 #

• 定位报错栈中的高亮代码行，确认哪个变量被赋值为null但声明为非空
• 所有可能返回null的方法，必须在返回值类型后添加?
• 避免随意使用!强制解包，除非能确保变量一定不为null

内容的提问来源于stack exchange，提问作者Brayn O'Ryan