现象与复现条件#

• 平台：iOS（应用沙盒文件）
• 音频格式：FLAC
• 表现：
  • seek 日志显示 position 已到目标值
  • 实际听感偏前，拖到结尾仍未到结尾
  • 歌曲时长无异常

日志示例（从 UI slider -> seek -> UI 认为“对齐”）：

1
[SLIDER] onChangeEnd: sliderValue=1.0, duration=247153ms, targetPosition=247153ms, actualPosition=5674ms
2
[SEEK] Request: target=247153ms, current=5869ms, duration=247153ms
3
[EFFECTIVE_POS] Aligned! actual=247153ms, pending=247153ms, delta=0ms
4
[SEEK] After seek(): position=247153ms

你看日志，完全没毛病：目标=247153ms、seek 后 position=247153ms、甚至 UI 的 “effectivePosition” 还打印了 Aligned!。但声音就是没到那儿。

排查路径（以及为什么这些路走不通）#

我一开始的直觉是“时长算错了 / 元数据不准”。毕竟拖到 100% 还不到尾部，很像 duration 出问题。

但很快就排掉了：同一首歌，无论用 on_audio_query 拿的 duration，还是解析 metadata 得到的 duration，显示都正常，且播放从头到尾的总时长也没问题。

接下来我开始怀疑是“UI 算法”或“状态更新延迟”，于是做了两件事：

1
onChangeEnd: (value) async {
2
  final targetPosition = Duration(
3
    milliseconds: (value * duration.inMilliseconds).toInt(),
4
  );
5
  debugPrint('[SLIDER] onChangeEnd: sliderValue=$value, '
6
      'duration=${duration.inMilliseconds}ms, '
7
      'targetPosition=${targetPosition.inMilliseconds}ms, '
8
      'actualPosition=${state.position.inMilliseconds}ms');
9
  await audioManager?.seek(targetPosition);
10
}

1
@override
2
Future<void> seek(Duration position) async {
3
  debugPrint('[SEEK] Request: target=${position.inMilliseconds}ms, '
4
      'current=${_player.position.inMilliseconds}ms, '
5
      'duration=${_player.duration?.inMilliseconds}ms');
6

7
  await _player.seek(position);
8

9
  debugPrint('[SEEK] After seek(): position=${_player.position.inMilliseconds}ms');
10

11
  await _player.processingStateStream
12
      .firstWhere((state) =>
13
          state == ProcessingState.ready ||
14
          state == ProcessingState.completed)
15
      .timeout(const Duration(seconds: 2),
16
          onTimeout: () => ProcessingState.ready);
17

18
  debugPrint('[SEEK] After ready: position=${_player.position.inMilliseconds}ms, '
19
      'processingState=${_player.processingState}');
20
}

定位到关键点：iOS 的精确时长/定位选项#

继续往下挖，我去翻了 just_audio 的 Darwin（iOS/macOS）实现。它本质上是用 AVURLAsset 创建 AVPlayerItem。在 Apple 的世界里，“快”和“准”是可以二选一的：默认情况下系统并不一定会用最精确的方式去解析时长与时间轴（尤其是本地文件、尤其是某些格式）。

just_audio 其实提供了一个开关，把它传到 AVURLAssetPreferPreciseDurationAndTimingKey 上：也就是 preferPreciseDurationAndTiming。

解决思路是：为 iOS 的 FLAC 文件启用精确时长/时间轴选项。

在 just_audio 里，这个选项对应：

1
DarwinAssetOptions(preferPreciseDurationAndTiming: true)

代码改动#

核心修改在 lib/core/services/audio_manager.dart，我最终做了三件事（这三件事组合起来才稳）：

1. 播放列表构建 AudioSource 时，不再用默认的 AudioSource.uri(...)（它会根据 URI 判断类型，但我需要更明确地控制 options）。
2. 改用 ProgressiveAudioSource(...)，并把 ProgressiveAudioSourceOptions 填进去（只对 iOS/macOS + .flac 启用精确模式）。
3. 同时把 duration 也传给 source（song.durationAsDuration），作为一个更稳定的兜底（避免某些文件解析 duration 走近似路径）。

关键实现（节选）：

1
AudioSource _buildAudioSource(LocalSongModel song) {
2
  final filePath = song.filePath;
3
  if (filePath != null && filePath.isNotEmpty) {
4
    final file = File(filePath);
5
    if (file.existsSync()) {
6
      return _buildProgressiveSource(
7
        Uri.file(filePath),
8
        song,
9
        isFlac: filePath.toLowerCase().endsWith('.flac'),
10
      );
11
    }
12
  }
13

14
  final uri = Uri.parse(song.uri);
15
  return _buildProgressiveSource(
16
    uri,
17
    song,
18
    isFlac: uri.path.toLowerCase().endsWith('.flac'),
19
  );
20
}
21

22
AudioSource _buildProgressiveSource(
23
  Uri uri,
24
  LocalSongModel song, {
25
  required bool isFlac,
26
}) {
27
  final usePreciseTiming =
28
      isFlac && (Platform.isIOS || Platform.isMacOS);
29
  final options = usePreciseTiming
30
      ? const ProgressiveAudioSourceOptions(
31
          darwinAssetOptions:
32
              DarwinAssetOptions(preferPreciseDurationAndTiming: true),
33
        )
34
      : null;
35

36
  return ProgressiveAudioSource(
37
    uri,
38
    tag: song,
39
    duration: song.durationAsDuration,
40
    options: options,
41
  );
42
}

然后在 setPlaylist 里统一用 _buildAudioSource 生成 playlist 的 children：

1
final audioSources = songs.map(_buildAudioSource).toList();
2
await _player.setAudioSource(
3
  ConcatenatingAudioSource(children: audioSources),
4
  initialIndex: _currentIndex,
5
);

这次修复的关键不是“再等一等”“再对齐一下 position”，而是让 iOS 在解析这个 FLAC 的时间轴时走精确路径。否则你在 Dart 层做再多校验，最终音频解码器/播放器层面还是会“跳到一个差不多的位置”。

结果#

• FLAC 拖动进度条与实际听感一致
• 拖到尾部能真正到尾部
• 日志与听感完全对齐

小结#

这个问题的难点在于：你能拿到的一切“状态”都在告诉你它对了，但最终用户体验仍然是错的。
从“检查 duration/元数据”到“怀疑 UI 算法/状态延迟”再到“翻平台实现”，最后才发现真正的开关在 iOS 的 AVURLAsset 上。

如果你遇到类似情况（iOS + FLAC + seek 不准），优先试：

1
DarwinAssetOptions(preferPreciseDurationAndTiming: true)

最后补一句经验：播放器这种东西，UI 层能做的“看起来正确”很有限；一旦出现「UI 正确但耳朵不对」，多半是平台层（解码/seek/时基）的问题，不要在 Dart 层硬耗太久。