You need to enable JavaScript to run this app. Hilt中如何自定义作用域 解决登出后登录Token实例未更新问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 05:54:11