Flutter Windows应用崩溃排查：video_player控制器未正确释放？

你的多区域视频播放场景中，代码存在几个核心问题，导致播放数秒后崩溃：

1. 监听器未正确移除，引发资源泄漏 #

在_onControllerChange的addPostFrameCallback里，你调用oldController.removeListener(() { });，传入的是全新的空匿名函数，根本无法移除之前绑定的监听器。旧控制器的监听器会持续存在，造成内存泄漏和回调冲突，最终触发崩溃。

修复：把监听器提取为独立方法，移除时传入同一个方法引用：

@override
void initState() {
  super.initState();
  _initController();
}

// 独立的监听器方法
void _videoListener() {
  if (_controller.value.isCompleted) {
    if (toogle) {
      currentIndex = (currentIndex + 1) % mediaItems.length;
      _onControllerChange(mediaItems[currentIndex].filePath ?? "");
    }
    toogle = !toogle;
  }
}

void _initController() {
  _controller = VideoPlayerController.file(File(mediaItems[currentIndex].filePath ?? ""))
    ..initialize().then((_) {
      setState(() {});
      _controller.setVolume(0.0);
      _controller.play();
      setState(() {});
    });
  // 绑定独立的监听器
  _controller.addListener(_videoListener);
}

移除监听器时传入正确的方法：

WidgetsBinding.instance.addPostFrameCallback((_) async {
  oldController.removeListener(_videoListener);
  oldController.dispose();
});

2. toogle变量未初始化，逻辑存在隐患 #

toogle没有初始值，默认是null，第一次判断if(toogle)会触发错误。而且视频初始化阶段isCompleted可能被误触发，现有逻辑无法可靠区分“刚初始化”和“播放完成”两种状态。

修复：初始化toogle为false，并通过判断播放位置是否到达总时长来确认视频真正完成：

// 初始化变量
bool toogle = false;

void _videoListener() {
  final controller = _controller;
  if (controller == null) return;
  final value = controller.value;
  // 确保控制器已初始化，且确实播放到末尾
  if (value.isInitialized && value.position >= value.duration) {
    if (toogle) {
      currentIndex = (currentIndex + 1) % mediaItems.length;
      _onControllerChange(mediaItems[currentIndex].filePath ?? "");
    }
    toogle = !toogle;
  }
}

3. 控制器切换流程混乱，资源未正确释放 #

_onControllerChange中，你在触发addPostFrameCallback后立刻调用_initController，新控制器会直接覆盖_controller，但旧控制器的dispose还未执行，可能导致多个控制器同时占用系统资源，引发冲突。

修复：先将_controller置为null，等待旧控制器完全释放后再初始化新控制器：

Future<void> _onControllerChange(String link) async {
  if (_controller == null) {
    _initController();
    return;
  }

  final oldController = _controller;
  // 先移除监听器并暂停播放
  oldController.removeListener(_videoListener);
  await oldController.pause();
  
  // 置为null，避免build阶段使用旧控制器
  setState(() {
    _controller = null;
  });

  // 等待下一帧完成后再销毁旧控制器
  await WidgetsBinding.instance.endOfFrame;
  await oldController.dispose();

  // 初始化新控制器
  _initController();
}

4. 未实现Widget的dispose方法 #

当Widget被销毁时，控制器资源未释放，多区域播放场景下会累积大量未释放的资源，最终导致崩溃。

修复：添加dispose方法释放资源：

@override
void dispose() {
  _controller?.removeListener(_videoListener);
  _controller?.dispose();
  super.dispose();
}

额外建议 #

• 多区域播放时，确保每个视频Widget独立管理自己的控制器，禁止共享实例。
• 可尝试限制同时播放的视频数量，对非前台区域的视频暂停播放，降低资源占用。

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