身份认证与应用安全 / 系统课时
登录成功后签发访问令牌
登录成功后签发访问令牌
本节解决认证通过后如何生成 Access Token 并返回给前端的问题。完成后,你将能把用户标识、签发时间和过期时间写入 JWT,并把令牌封装进统一登录响应,同时避免把敏感或频繁变化的数据塞进 Token。
学习目标
- 在用户名密码认证成功后签发带有效期的 JWT Access Token
- 正确选择
sub、iat、exp等核心声明 - 通过统一登录响应向前端返回令牌类型和有效期
把签发放在认证成功之后
JWT 的签发动作应发生在服务器已经确认用户身份之后。典型登录链路是:接收用户名密码、查询用户、校验密码和账号状态,全部通过后才调用令牌服务。Token 不是密码校验工具,而是认证成功后由服务器签发的后续访问凭证。

在 JWT 中,最适合充当用户身份主键的是标准声明 sub。iat 表示签发时间,exp 表示过期时间。对于访问令牌,通常只携带请求鉴权真正需要的数据,不应放入密码、手机号等敏感信息,也不宜复制完整用户资料。
| 声明 | 用途 | 示例 |
|---|---|---|
sub |
标识当前用户 | 1001 |
iat |
记录签发时间 | 当前时间 |
exp |
限制令牌有效期 | 当前时间加 15 分钟 |
如果把角色、权限等频繁变化的数据写进 JWT,需要接受一个事实:服务端修改权限后,旧 Token 中的数据不会自动更新,只能等待令牌过期或额外实现撤销机制。
完成一个可执行签发示例
下面示例使用 JJWT 0.12.x API,假定 Spring Boot 工程已经引入对应的 jjwt-api、jjwt-impl 和 jjwt-jackson 依赖。示例密钥仅用于本地演示,HS256 至少需要 256 位密钥,生产环境应从环境变量或 Secret 管理系统读取。
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.security.Keys;
import javax.crypto.SecretKey;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.time.Instant;
import java.util.Date;
public class JwtIssueDemo {
private static final SecretKey KEY = Keys.hmacShaKeyFor(
"0123456789abcdef0123456789abcdef"
.getBytes(StandardCharsets.UTF_8));
public static String issueAccessToken(String userId, Duration ttl) {
Instant now = Instant.now();
return Jwts.builder()
.subject(userId)
.issuedAt(Date.from(now))
.expiration(Date.from(now.plus(ttl)))
.signWith(KEY)
.compact();
}
public record LoginResponse(
String accessToken,
String tokenType,
long expiresIn) {
}
public static void main(String[] args) {
Duration ttl = Duration.ofMinutes(15);
String token = issueAccessToken("1001", ttl);
LoginResponse response = new LoginResponse(
token,
"Bearer",
ttl.toSeconds());
System.out.println("tokenType=" + response.tokenType());
System.out.println("expiresIn=" + response.expiresIn());
System.out.println("accessToken="
+ (response.accessToken().startsWith("eyJ") ? "<TOKEN>" : "invalid"));
}
}预期输出(实际 JWT 字符串会随签发时间和签名变化):
tokenType=Bearer
expiresIn=900
accessToken=<TOKEN>这里的 expiresIn 使用秒数,便于前端计算令牌剩余时间;真正决定服务端是否接受 Token 的仍然是 JWT 内部的 exp。两者应来自同一个 TTL 配置,避免登录响应显示 15 分钟、实际 Token 却签发成其他时长。
返回统一登录响应
认证控制器在用户校验成功后,只需要调用类似 issueAccessToken(userId, ttl) 的方法,再返回 LoginResponse。前端拿到结果后通常把令牌用于后续请求的 Authorization: Bearer <TOKEN> 请求头,而不是再次发送用户名和密码。
Access Token 的有效期应根据风险和用户体验确定,15 分钟只是演示值。无论选择多长时间,都应保证签发端和校验端使用一致的密钥、算法和时间策略,并让客户端把令牌当作不透明凭证,而不是自行修改其中的声明。