Flutter集成just_audio包崩溃：找不到AudioServiceActivity类

算力阿峰

2026-7-18

解决方案

从报错信息来看，核心问题是Android系统无法找到com.ryanheise.audioservice.AudioServiceActivity类，这个类属于audio_service插件，通常由依赖缺失或配置错误导致，按以下步骤排查修复：

添加audio_service依赖
如果项目需要后台音频播放功能（或之前配置过相关逻辑），需在pubspec.yaml中添加依赖：
```
dependencies:
  audio_service: ^0.18.11 # 使用与just_audio兼容的最新版本
```
执行命令更新依赖：
```
flutter pub get
```

检查并修正AndroidManifest配置
打开android/app/src/main/AndroidManifest.xml：

若需使用AudioServiceActivity，确保已正确注册（需先添加上述依赖）：

<activity android:name="com.ryanheise.audioservice.AudioServiceActivity"
    android:exported="true"
    android:launchMode="singleTop"
    android:theme="@style/Theme.AppCompat.NoActionBar">
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity>

若不需要后台播放功能，直接删除上述Activity注册代码，避免系统尝试启动不存在的类。

彻底清理重建项目
执行以下命令清理缓存并重新构建：
```
flutter clean
flutter pub get
```
同时卸载设备上的旧应用，再重新安装调试版本。
验证版本兼容性
确保just_audio与audio_service版本兼容，可参考just_audio官方文档确认推荐的依赖版本，避免版本冲突导致类加载失败。