Flutter集成just_audio与just_audio_background时应用崩溃求助

问题核心分析 #

从描述来看，硬编码URL和元数据时播放正常，但使用动态数据（从video/audio字典取值）时崩溃，说明问题大概率出在动态数据的合法性、空安全处理，或者Android平台的网络配置上，而非just_audio本身的基础功能。

分步解决方案 #

1. 排查动态数据的合法性与空安全

动态数据可能存在null、空字符串或非法格式，直接使用会导致空指针或Uri解析错误：

• 添加日志验证数据：在创建AudioSource前打印所有动态字段，确认没有空值或非法内容：

  print('音频URL: ${video["audio"]}');
  print('分类名称: ${audio["subCategory"]?["name"]}');
  print('音频标题: ${audio["title"]}');
  print('封面URL: ${audio["image"]}');
  

• 强制判空处理：对所有动态字段做非空校验，避免空值传递给AudioSource或MediaItem：

  // 提取并校验动态数据
  final audioUrl = video["audio"] ?? '';
  if (audioUrl.isEmpty) {
    ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("音频地址无效")));
    return;
  }
  final subCategory = audio["subCategory"];
  final albumName = subCategory?["name"] ?? "未知分类";
  final audioTitle = audio["title"] ?? "未知标题";
  final coverUrl = audio["image"] ?? '';
  
  // 创建AudioSource
  final audioSource = AudioSource.uri(
    Uri.parse(audioUrl),
    tag: MediaItem(
      id: "1", // 直接用字符串，避免不必要的类型转换
      album: albumName,
      title: audioTitle,
      artUri: coverUrl.isNotEmpty ? Uri.parse(coverUrl) : null,
    ),
  );
  

2. 检查Android 12的网络配置

Android 12默认禁止明文HTTP请求，如果你的音频URL是HTTP而非HTTPS，必须配置允许明文流量：

1. 在android/app/src/main/res/xml目录下创建network_security_config.xml（没有xml目录就新建）：

   <?xml version="1.0" encoding="utf-8"?>
   <network-security-config>
       <base-config cleartextTrafficPermitted="true" />
   </network-security-config>
   

2. 在AndroidManifest.xml的<application>标签中添加配置引用：

   <application
       ...
       android:networkSecurityConfig="@xml/network_security_config">
   

3. 确保已添加网络权限：

   <uses-permission android:name="android.permission.INTERNET" />
   

3. 避免跨路由传递AudioSource对象

AudioSource并非可序列化对象，直接通过路由传递可能导致对象损坏。改为传递原始数据，在目标页面创建AudioSource：

• 跳转时只传基础数据：

  Navigator.push(
    context,
    SlideRightRoute(
      page: AudioPlayPage(
        audios: widget.videos,
        categoryImage: subCategory?["image"] ?? '',
        category: albumName,
        initialAudio: video,
        url: audioUrl,
        image: coverUrl,
        title: audioTitle,
        // 移除audio参数
      ),
    ),
  );
  

• 在目标页面初始化AudioSource：

  Future<void> _init() async {
    if (widget.url.isEmpty) return;
    try {
      final audioSource = AudioSource.uri(
        Uri.parse(widget.url),
        tag: MediaItem(
          id: "1",
          album: widget.category,
          title: widget.title,
          artUri: widget.image.isNotEmpty ? Uri.parse(widget.image) : null,
        ),
      );
      await _player.setAudioSource(audioSource);
    } catch (e, stackTrace) {
      // 捕获并打印错误，方便排查
      print("播放器初始化失败: $e");
      print(stackTrace);
    }
  }
  

4. 增强错误捕获与空安全

在StreamBuilder中增加错误处理，避免空指针崩溃：

StreamBuilder<SequenceState?>(
  stream: _player.sequenceStateStream,
  builder: (context, snapshot) {
    // 处理流错误
    if (snapshot.hasError) {
      return Center(child: Text("加载失败: ${snapshot.error}"));
    }
    final state = snapshot.data;
    if (state?.sequence.isEmpty ?? true) {
      // 原占位UI
      return Container(...);
    }
    // 逐层判空，避免空指针
    final currentSource = state?.currentSource;
    if (currentSource == null) return Container(...);
    final metadata = currentSource.tag as MediaItem?;
    return _currentAudio(metadata ?? MediaItem(id: "1", title: "未知"), _player);
  },
)

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