Flutter报错：类型'Null'不是'List<Carousel>'的子类型，求排查

使用Carousel Slider库开发时触发错误：type 'Null' is not a subtype of type 'List<Carousel>'，自行排查未找到问题根源，以下是涉及的RemoteService和HomeController代码，请求帮忙定位问题。

RemoteService 代码 #

import 'package:http/http.dart' as http;
import 'package:multi_shop/model/carousel.dart';

class RemoteService {
  static var client = http.Client();

  static Future<dynamic> fetchCarouselData() async {
    try{
      final response = await client.get(
        Uri.parse('https://my-shop.com/home-carousels'),
      );
      if(response.statusCode == 200){
        return carouselFromJson(response.body);
      }
      return null;
    } catch(e){
      return null;
    }
  }
}

HomeController 代码 #

import 'package:get/get.dart';
import 'package:get_storage/get_storage.dart';
import 'package:multi_shop/http/remote_services.dart';
import 'package:multi_shop/model/carousel.dart';

class HomeController extends GetxController{
  var box = GetStorage();
  var isLoading = false;
  List<Carousel> carouselData = [];

  @override
  void onInit() {
    fetchCarousel();
    if(box.read('carouselData') != null) {
      carouselData.assignAll(box.read('carouselData'));
    }
    super.onInit();
  }

  void fetchCarousel() async {
    try{
      isLoading = true;
      update();
      List<Carousel> data = await RemoteService.fetchCarouselData();
      carouselData.assignAll(data);
      box.write('carouselData', data);
    }finally{
      isLoading = false;
      update();
      print('data fetch done');
    }
  }
}

错误原因分析 #

• 未处理null返回：RemoteService.fetchCarouselData在请求失败（非200状态码或抛出异常）时返回null，但HomeController中直接将返回值强转为List<Carousel>，触发类型转换错误。
• 本地存储数据类型风险：box.read('carouselData')读取的数据可能无法正确转为List<Carousel>，直接调用assignAll也可能引发类型问题。

修复方案 #

1. 处理RemoteService的null返回 #

修改HomeController的fetchCarousel方法，先判断返回值有效性再赋值：

void fetchCarousel() async {
  try{
    isLoading = true;
    update();
    final responseData = await RemoteService.fetchCarouselData();
    if(responseData != null && responseData is List<Carousel>){
      carouselData.assignAll(responseData);
      box.write('carouselData', responseData);
    } else {
      // 可选：处理数据为空的情况，比如清空列表或加载默认数据
      carouselData.clear();
    }
  }finally{
    isLoading = false;
    update();
    print('data fetch done');
  }
}

2. 优化RemoteService返回类型 #

明确返回可为空的列表类型，避免动态类型的不确定性：

static Future<List<Carousel>?> fetchCarouselData() async {
  try{
    final response = await client.get(
      Uri.parse('https://my-shop.com/home-carousels'),
    );
    if(response.statusCode == 200){
      return carouselFromJson(response.body);
    }
    return null;
  } catch(e){
    print('请求异常：$e');
    return null;
  }
}

3. 安全读取本地存储数据 #

读取本地数据时添加类型校验，必要时手动转换为Carousel对象：

@override
void onInit() {
  fetchCarousel();
  final localData = box.read('carouselData');
  if(localData != null && localData is List){
    // 若存储的是Map列表，需转换为Carousel对象
    carouselData.assignAll(localData.map((item) => Carousel.fromJson(item)).toList());
    // 若存储的是已序列化的Carousel列表，可直接强转：
    // carouselData.assignAll(localData as List<Carousel>);
  }
  super.onInit();
}

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