Android动态更新Token方案：从架构设计到安全实践

1次阅读

没有评论

共计 2863 个字符，预计需要花费 8 分钟才能阅读完成。

在移动应用开发中，Token 的动态更新是保障安全性的关键环节。然而，开发者常常面临以下典型问题：

401 错误频发 ：Token 过期后，用户会被强制退出，严重影响用户体验
并发请求时的 Token 竞争 ：当多个请求同时检测到 Token 过期时，会触发多次 Token 更新请求
网络延迟导致的更新失败 ：在网络不稳定的情况下，Token 更新可能失败，导致后续请求无法正常进行
Token 存储安全问题 ：如何安全地存储 Token，防止被恶意应用窃取

在移动端 Token 管理中，常见的技术方案有以下几种：

Cookie 方案 ：
优点：实现简单，浏览器自动管理
缺点：移动端兼容性差，安全性较低
单 Token 方案 ：
优点：实现简单，适用于小型应用
缺点：Token 过期后用户需要重新登录，体验差
双 Token 机制（Access+Refresh）：
优点：用户体验好，安全性高
缺点：实现复杂度较高

基于以上对比，我们选择双 Token 机制作为解决方案，因为它能提供更好的用户体验和更高的安全性。

我们使用 Kotlin 实现一个 OkHttp 拦截器来自动处理 Token 更新：

class TokenInterceptor(private val tokenManager: TokenManager) : Interceptor {@Throws(IOException::class)
    override fun intercept(chain: Interceptor.Chain): Response {val originalRequest = chain.request()

        // 添加 Access Token 到请求头
        val requestWithToken = originalRequest.newBuilder()
            .header("Authorization", "Bearer ${tokenManager.getAccessToken()}")
            .build()

        var response = chain.proceed(requestWithToken)

        // 如果响应是 401，尝试刷新 Token
        if (response.code == 401) {synchronized(this) {val newAccessToken = tokenManager.refreshToken()
                if (newAccessToken != null) {
                    // 使用新 Token 重试请求
                    val newRequest = originalRequest.newBuilder()
                        .header("Authorization", "Bearer $newAccessToken")
                        .build()
                    response.close()
                    return chain.proceed(newRequest)
                }
            }
        }

        return response
    }
}

class TokenManager(private val apiService: ApiService) {private val mutex = Mutex()

    suspend fun getAccessToken(): String {
        // 从安全存储中获取 Access Token
        var token = SecureStorage.getAccessToken()

        // 检查 Token 是否有效
        if (token != null && !isTokenExpired(token)) {return token}

        // 如果 Token 无效，尝试刷新
        return mutex.withLock {token = SecureStorage.getAccessToken()
            if (token != null && !isTokenExpired(token!!)) {return@withLock token!!}

            // 调用刷新 Token 接口
            val refreshToken = SecureStorage.getRefreshToken()
            if (refreshToken == null) {throw AuthenticationException("No valid refresh token")
            }

            val response = apiService.refreshToken(refreshToken).execute()
            if (response.isSuccessful) {val newTokens = response.body()!!
                SecureStorage.saveAccessToken(newTokens.accessToken)
                SecureStorage.saveRefreshToken(newTokens.refreshToken)
                newTokens.accessToken
            } else {throw AuthenticationException("Failed to refresh token")
            }
        }
    }

    private fun isTokenExpired(token: String): Boolean {
        // 解析 JWT，检查过期时间
        val claims = JWT.decode(token).claims
        val exp = claims["exp"]?.asDate() ?: return true
        return exp.before(Date())
    }
}

我们对比两种常见的 Token 存储方案：