Hilt中如何自定义作用域 解决登出后登录Token实例未更新问题
会话级Token作用域实现方案
针对Singleton无法随登出流程更新Token的问题,Hilt本身支持实现「短于Application生命周期、长于单个Activity」的可控作用域,不需要手动编写复杂的依赖容器逻辑,核心流程如下:
- 第一步:定义自定义会话作用域注解
创建用于标记登录态专属依赖的作用域注解,作为所有会话级依赖的统一标记:@Scope @Retention(AnnotationRetention.RUNTIME) annotation class LoggedInUserScope - 第二步:创建可手动控制生命周期的自定义Hilt组件
将该组件的父组件绑定为ApplicationComponent,确保可以访问Application层级的所有全局依赖,同时组件实例由业务代码手动持有,不跟随Application同生命周期:@LoggedInUserScope @DefineComponent(parent = ApplicationComponent::class) interface LoggedInUserComponent { // 给基类Activity做依赖注入 fun inject(activity: BaseLoggedInActivity) // 构建组件时直接将新Token作为绑定实例传入,从根源避免旧值残留 @DefineComponent.Builder interface Builder { fun bindToken(@BindsInstance token: String): Builder fun build(): LoggedInUserComponent } } - 第三步:在Application中维护组件的创建与销毁逻辑
持有可空的会话组件引用,在登录、登出的业务节点触发组件状态变更:@HiltAndroidApp class MyApplication : Application() { // 全局可访问的会话组件引用,置空即代表会话结束 var loggedInUserComponent: LoggedInUserComponent? = null private set // 登录成功回调:用新Token构建全新的会话组件 fun onUserLoginSuccess(newToken: String) { val appComponent = (this as Hilt_MyApplication).applicationComponent loggedInUserComponent = appComponent.loggedInUserComponentBuilder() .bindToken(newToken) .build() } // 登出回调:清空会话组件,销毁所有会话级依赖 fun onUserLogout() { loggedInUserComponent = null } } - 第四步:完成业务页面的依赖注入适配
针对所有非Login的已登录页面,统一通过会话组件完成依赖注入,Login Activity不接入该注入逻辑,匹配需求:// 所有需要登录态才能访问的页面继承该基类 abstract class BaseLoggedInActivity : AppCompatActivity() { // 直接注入当前会话下的Token实例 @Inject lateinit var currentToken: String override fun onCreate(savedInstanceState: Bundle?) { val sessionComponent = (application as MyApplication).loggedInUserComponent ?: run { // 无有效会话直接跳转登录页做兜底 startActivity(Intent(this, LoginActivity::class.java)) finish() return } sessionComponent.inject(this) super.onCreate(savedInstanceState) } }
轻量化替代方案
如果需要更短的实现路径,不想编写自定义Hilt组件,可以用会话存储类的方式快速实现:
- 定义一个用
@ActivityRetainedScoped标记的存储类,内部持有Token值,提供更新、清空的方法 - 所有需要用到Token的页面直接注入这个存储类,从类中读取当前有效Token
- 登录成功时调用更新方法传入新Token,登出时调用清空方法重置值
该方案的局限是作用域绑定在ActivityRetainedComponent上,不是全局登录态唯一,系统在内存不足时销毁栈顶Activity后,存储类实例会丢失,需要额外做状态恢复,仅适合简单业务场景。
常见踩坑提醒
- 不要将会话级的Token依赖继续用
@Singleton标记,否则依赖会被提升到Application层级管理,会话组件的销毁逻辑会直接失效 - 所有安装到会话组件的模块,里面的依赖提供方法必须用自定义的
@LoggedInUserScope标记,确保实例不会被其他作用域缓存
内容的提问来源于stack exchange,提问作者user3540530
相关产品推荐
相关产品推荐

