Flutter iOS端AudioService查看通知时自行销毁问题排查

问题核心原因 #

iOS平台对音频后台生命周期的管控更严格，你的代码存在几个关键问题：

1. 音频会话配置时机过晚，未在服务启动阶段完成系统权限申请
2. 播放事件监听器重复注册，导致状态同步逻辑混乱
3. 缺少iOS专属的会话中断/恢复处理逻辑
4. 服务初始化逻辑分散，App状态切换时无法自动恢复播放状态

具体修复步骤 #

1. 重构AudioServiceHandler构造函数，提前完成核心初始化 #

将音频会话配置、事件监听等基础逻辑移到构造函数，确保服务启动时就完成系统级配置：

class AudioServiceHandler extends BaseAudioHandler with SeekHandler {
  final AudioPlayer audioPlayer = AudioPlayer();
  late List<MediaItem> _currentPlaylist;

  AudioServiceHandler() {
    _initAudioSession();
    _setupEventListeners();
  }

  // 独立初始化音频会话，处理iOS系统事件
  Future<void> _initAudioSession() async {
    final session = await AudioSession.instance;
    await session.configure(const AudioSessionConfiguration.music());
    
    // 处理锁屏/后台切换时的音频中断
    session.interruptionEventStream.listen((event) {
      if (event.type == InterruptionType.began) {
        pause();
      } else if (event.type == InterruptionType.ended && event.action == InterruptionAction.resume) {
        play();
      }
    });
    
    // 处理音频路由变化（比如拔出耳机）
    session.becomingNoisyEventStream.listen((_) {
      pause();
    });
  }

  // 统一注册所有事件监听器，避免重复注册
  void _setupEventListeners() {
    audioPlayer.playbackEventStream.listen(_broadcastState);
    audioPlayer.currentIndexStream.listen(_updateCurrentMediaItem);
    audioPlayer.processingStateStream.listen(_handleProcessingState);
  }

2. 修复重复监听问题，简化状态广播逻辑 #

原代码中broadcastState方法内部嵌套监听播放流，导致多次注册监听器，改为直接接收事件更新状态：

// 修正后的状态广播方法
void _broadcastState(PlaybackEvent event) {
  final playing = audioPlayer.playing;
  playbackState.add(playbackState.value.copyWith(
    controls: [
      MediaControl.skipToPrevious,
      playing ? MediaControl.pause : MediaControl.play,
      MediaControl.stop,
      MediaControl.skipToNext,
    ],
    systemActions: const {MediaAction.seek},
    androidCompactActionIndices: const [0, 1, 3],
    processingState: {
      ProcessingState.idle: AudioProcessingState.idle,
      ProcessingState.loading: AudioProcessingState.loading,
      ProcessingState.buffering: AudioProcessingState.buffering,
      ProcessingState.ready: AudioProcessingState.ready,
      ProcessingState.completed: AudioProcessingState.completed,
    }[audioPlayer.processingState]!,
    repeatMode: {
      LoopMode.off: AudioServiceRepeatMode.none,
      LoopMode.one: AudioServiceRepeatMode.one,
      LoopMode.all: AudioServiceRepeatMode.all,
    }[audioPlayer.loopMode]!,
    shuffleMode: audioPlayer.shuffleModeEnabled
        ? AudioServiceShuffleMode.all
        : AudioServiceShuffleMode.none,
    playing: playing,
    updatePosition: audioPlayer.position,
    bufferedPosition: audioPlayer.bufferedPosition,
    speed: audioPlayer.speed,
    queueIndex: event.currentIndex,
  ));
}

3. 简化initSongs方法，聚焦播放列表加载 #

把初始化逻辑拆分，避免重复设置监听器：

Future<void> initSongs({required List<MediaItem> songs}) async {
  _currentPlaylist = songs;
  final audioSource = ConcatenatingAudioSource(
    children: songs.map(createAudioSource).toList(),
  );
  await audioPlayer.setAudioSource(audioSource);
  queue.add(songs);
}

4. 拆分辅助方法，提高代码可读性 #

把原分散的监听逻辑拆分为独立方法：

// 更新当前媒体项
void _updateCurrentMediaItem(int? index) {
  final playlist = queue.value;
  if (index == null || playlist.isEmpty) return;
  mediaItem.add(playlist[index]);
}

// 处理播放完成逻辑
void _handleProcessingState(ProcessingState state) async {
  if (state == ProcessingState.completed) {
    final currentIndex = audioPlayer.currentIndex ?? 0;
    if (currentIndex >= _currentPlaylist.length - 1) {
      await skipToQueueItem(0);
      pause();
    } else {
      skipToNext();
    }
  }
}

5. 检查iOS项目配置 #

确保已开启后台音频权限：

• 打开ios/Runner/Info.plist，添加配置：

<key>UIBackgroundModes</key>
<array>
  <string>audio</string>
</array>

• 在Xcode中进入项目设置 -> Signing & Capabilities -> 添加Background Modes，勾选Audio, AirPlay, and Picture in Picture。

关键说明 #

• 构造函数是音频服务的核心初始化入口，必须在这里完成会话配置和监听器注册，避免App状态切换时服务重建后丢失配置
• iOS要求音频会话在服务启动阶段就完成配置，否则系统不会授予后台播放权限
• 重复注册事件监听器会导致状态同步混乱，必须确保每个流只注册一次监听器

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