Flutter热重启时dispose方法未触发，如何正确释放重量级资源？

核心原因 #

热重启只会重启Dart层的应用逻辑，不会触发Widget的dispose生命周期回调，且原生侧持有资源（如音频播放实例、文件句柄、原生通道连接）不会被VM自动回收，因此会出现资源泄漏、多音频重叠的问题。

可行解决方案 #

方案1：使用reassemble回调处理当前页面资源清理 #

State类自带的reassemble方法仅在开发模式下热重载/热重启时触发，刚好适合处理开发阶段的热重启资源释放，只需在你的页面State中新增该回调即可：

@override
void reassemble() async {
  // 先停止并释放当前音频实例
  await audioPlayer.stop();
  await audioPlayer.dispose();
  super.reassemble();
}

该方法不会在生产环境执行，无需担心线上性能影响。

方案2：全局入口处统一清理残留资源 #

热重启后会重新执行main函数，因此可以在runApp之前统一清理所有音频类残留资源，适配所有页面的音频泄漏场景：

import 'package:flutter/foundation.dart';

void main() async {
  // 仅开发模式执行热重启资源清理
  if (kDebugMode) {
    // 停止所有正在播放的音频
    await AudioPlayer.stopAll();
  }
  runApp(MaterialApp(home: const MyHomePage()));
}

注：你使用的audioplayers: ^0.20.1版本已内置AudioPlayer.stopAll()静态方法，可直接调用清理所有音频实例。

方案3：全局音频单例管理（推荐长期使用） #

如果应用内多处使用音频播放，建议封装全局音频管理单例，统一管理音频实例的创建、复用、销毁逻辑，避免多处创建实例导致的资源泄漏：

class AudioManager {
  AudioManager._internal();
  static final AudioManager _instance = AudioManager._internal();
  factory AudioManager() => _instance;

  AudioPlayer? _player;

  Future<AudioPlayer> getPlayer() async {
    if (_player == null) {
      _player = AudioPlayer();
    }
    return _player!;
  }

  Future<void> dispose() async {
    await _player?.stop();
    await _player?.dispose();
    _player = null;
  }
}

使用时直接通过AudioManager()获取实例，热重启时在main函数中调用AudioManager().dispose()即可一次性清理所有音频资源。

内容的提问来源于stack exchange，提问作者S.D.