为什么Dart函数未返回子函数结果？Flutter音乐拉取功能异常排查

问题根源 #

• 核心问题是不安全的强制类型转换：getPersonalFmMusicsFromQueue函数的返回类型是Future<List<Music>?>，允许返回null，但你在调用时强行通过as FutureOr<List<Music>>将其转换为不可空的List<Music>类型。当运行时返回值为null或者类型不匹配时，会直接抛出类型转换异常，导致后续代码终止执行，所以你在toMetadataList那行的断点不会被触发。
• 其次是缺失异常捕获逻辑：异步代码抛出的异常如果没有被主动捕获，很容易被上层播放队列的调度逻辑吞掉，因此控制台看不到错误输出。
• 额外需要确认queue.queueId == kFmPlayQueueId的判断是否命中，若判断不成立也不会走你自定义的分支逻辑。

修复方案 #

1. 移除强制类型转换，兼容空返回场景 #

修改fetchMoreMusic方法的调用逻辑，去掉不安全的强转，增加异常捕获方便排查问题：

class QuietPlayQueueInterceptor extends PlayQueueInterceptor {
  @override
  Future<List<MusicMetadata>> fetchMoreMusic(BackgroundPlayQueue queue, PlayMode playMode) async {
    if (queue.queueId == kFmPlayQueueId) {
      try {
        // 移除不安全的as强转，直接接受nullable的返回值
        final List<Music>? musics = await neteaseRepository!.getPersonalFmMusicsFromQueue();
        // 处理空返回，降级到父类逻辑或者返回空列表
        if (musics == null || musics.isEmpty) {
          return super.fetchMoreMusic(queue, playMode);
        }
        final musicListExt = musics.toMetadataList();
        return musicListExt;
      } catch (e, stackTrace) {
        // 打印异常信息方便后续排查
        debugPrint('拉取FM音乐异常: $e\n堆栈信息: $stackTrace');
        return super.fetchMoreMusic(queue, playMode);
      }
    }
    return super.fetchMoreMusic(queue, playMode);
  }
}

2. 可选：优化getPersonalFmMusicsFromQueue避免返回null #

如果业务逻辑上该函数不应该返回null，可以修改返回类型为非空，减少上层的空判断逻辑：

Future<List<Music>> getPersonalFmMusicsFromQueue() async {
  if(fmPlayQueue.isEmpty){
    // 保证getPersonalFmMusics返回非空，为空时返回空列表
    return await getPersonalFmMusics() ?? [];
  }else{
    final Music music = fmPlayQueue.first;
    // async方法自动包裹Future，无需手动调用Future.value
    return [music];
  }
}

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