为何我的Kotlin Compose Android应用存在多个Player实例？

为什么标记为单例的Player会出现多实例？ #

以下是几种常见原因：

• Hilt配置不严谨：即使PlayerModule安装在SingletonComponent，如果@Provides方法未添加@Singleton注解（虽Hilt在SingletonComponent中默认单例，但显式标注更保险），或Player类的构造函数未通过@Inject暴露，可能导致Hilt无法正确维护单例。
• PlayerService手动实例化Player：如果PlayerService未使用Hilt注入Player，而是直接new Player()，会生成独立于ViewModel的Player实例，造成多实例冲突。
• 跨进程问题：若给PlayerService设置了android:process属性使其运行在独立进程，进程间的单例无法共享，自然会出现多个Player实例。
• ViewModel作用域错误：如果之前获取PlayerViewModel的方式不是hiltViewModel()，而是手动创建或使用了错误的作用域（如Application级ViewModel），可能间接导致Player实例被重复创建（核心还是单例配置问题）。

正确实现：独立PlayerViewModel + 共享单例Player #

按照以下步骤调整，即可实现每个屏幕拥有独立ViewModel，但共享同一个Player实例：

1. 严格配置Player单例
   确保PlayerModule的@Provides方法显式标注@Singleton，且Player类通过构造注入或模块提供单例：

   @Module
   @InstallIn(SingletonComponent::class)
   object PlayerModule {
       @Provides
       @Singleton
       fun providePlayer(context: Context): Player {
           val exoPlayer = ExoPlayer.Builder(context).build()
           return Player(exoPlayer)
       }
   }
   

   所有使用Player的地方必须通过Hilt注入，禁止手动实例化。

2. PlayerService正确注入Player
   给PlayerService添加@AndroidEntryPoint注解，通过Hilt注入单例Player：

   @AndroidEntryPoint
   class PlayerService : ForegroundService() {
       @Inject
       lateinit var player: Player
   
       // 前台服务逻辑实现
   }
   

3. PlayerViewModel的正确实现
   用@HiltViewModel标记ViewModel，构造函数注入单例Player，确保每个屏幕通过hiltViewModel()获取独立实例：

   @HiltViewModel
   class PlayerViewModel @Inject constructor(
       private val player: Player
   ) : ViewModel() {
       // 播放器相关逻辑，如播放控制、状态监听等
   }
   

   在Compose屏幕中获取ViewModel：

   val playerViewModel = hiltViewModel<PlayerViewModel>()
   

4. 移除Application级持有PlayerViewModel的方案
   该方案会将PlayerViewModel变成全局单例，违背“每个屏幕独立ViewModel”的设计初衷，还可能引发内存泄漏，应立即替换为上述Hilt标准实现。

5. 验证单例一致性
   在Player构造函数中打印实例的hashCode，检查ViewModel、PlayerService中注入的Player实例哈希值是否一致，确认单例生效。

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