Token有效期详解 ​

Sa-Token 提供两种 Token 自动过期策略，分别是 timeout 与 active-timeout，配置方法如下：

sa-token: 
	# token 有效期（单位：秒），默认30天，-1代表永不过期 
	timeout: 2592000
	# token 最低活跃频率（单位：秒），如果 token 超过此时间没有访问系统就会被冻结，默认-1 代表不限制，永不冻结
	active-timeout: -1

两者的区别，可以通过下面的例子体现：

下面是对两个过期策略的详细解释：

timeout ​

1. timeout代表 Token 的长久有效期，单位/秒，例如将其配置为 2592000 (30天)，代表在30天后，Token必定过期，无法继续使用。
2. timeout无法续签，想要继续使用必须重新登录。v1.29.0+ 版本新增续期方法：StpUtil.renewTimeout(100)。
3. timeout的值配置为-1后，代表永久有效，不会过期。

active-timeout ​

1. active-timeout代表最低活跃频率，单位/秒，例如将其配置为 1800 (30分钟)，代表用户如果30分钟无操作，则此Token会立即过期（被冻结，但不会删除掉）。
2. 如果在30分钟内用户有操作，则会再次续签30分钟，用户如果一直操作则会一直续签，直到连续30分钟无操作，Token才会过期。
3. active-timeout的值配置为-1后，代表永久有效，不会过期，此时也无需频繁续签。

关于active-timeout的续签 ​

如果active-timeout配置了大于零的值，Sa-Token 会在登录时开始计时，在每次直接或间接调用getLoginId()、getTokenSession()时进行一次冻结检查与续签操作。 此时会有两种情况：

1. 一种是会话无操作时间太长，Token已经被冻结，此时框架会抛出NotLoginException异常(场景值=-3)，
2. 另一种则是会话在active-timeout有效期内通过检查，此时Token可以成功续签

我可以手动续签 active-timeout 吗？ ​

可以！ 如果框架的自动续签算法无法满足您的业务需求，你可以进行手动续签，Sa-Token 提供两个API供你操作：

1. StpUtil.checkActiveTimeout(): 检查当前Token 是否已经被冻结，如果是则抛出异常
2. StpUtil.updateLastActiveToNow(): 续签当前Token：(将 [最后操作时间] 更新为当前时间戳)

注意：在手动续签时，即使 Token 已经被冻结也可续签成功（解冻），如果此场景下需要提示续签失败，可采用先检查再续签的形式保证Token有效性

例如以下代码：

// 先检查是否已被冻结
StpUtil.checkActiveTimeout();
// 检查通过后继续续签
StpUtil.updateLastActiveToNow();

同时，你还可以关闭框架的自动续签（在配置文件中配置 autoRenew=false ），此时续签操作完全由开发者控制，框架不再自动进行任何续签操作

如果你需要给其它 Token 续签：

// 为指定 Token 续签 
StpUtil.stpLogic.updateLastActiveToNow(tokenValue);

timeout 与 active-timeout 可以同时使用吗？ ​

可以同时使用！ 两者的认证逻辑彼此独立，互不干扰，可以同时使用。

StpUtil 类中哪些方法支持自动续签 active-timeout? ​

直接或间接调用过 getLoginId()、getTokenSession() 的方法

以下注解都间接调用过 getLoginId() 方法