2026-06-16 16:02:09 +08:00
|
|
|
|
package com.webgame.webgamebackend.service.impl;
|
|
|
|
|
|
|
|
|
|
|
|
import com.webgame.webgamebackend.common.exception.BusinessException;
|
|
|
|
|
|
import com.webgame.webgamebackend.common.exception.ErrorCode;
|
|
|
|
|
|
import com.webgame.webgamebackend.service.RefreshTokenService;
|
|
|
|
|
|
import lombok.extern.slf4j.Slf4j;
|
2026-06-16 18:20:11 +08:00
|
|
|
|
import org.springframework.data.redis.core.StringRedisTemplate;
|
2026-06-16 16:02:09 +08:00
|
|
|
|
import org.springframework.stereotype.Service;
|
|
|
|
|
|
|
|
|
|
|
|
import java.security.SecureRandom;
|
|
|
|
|
|
import java.util.HexFormat;
|
2026-06-16 18:20:11 +08:00
|
|
|
|
import java.util.concurrent.TimeUnit;
|
2026-06-16 16:02:09 +08:00
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* 刷新令牌服务实现,基于 Redis 存储
|
|
|
|
|
|
*
|
|
|
|
|
|
* <p>数据结构:</p>
|
|
|
|
|
|
* <ul>
|
|
|
|
|
|
* <li>xzg:refresh:{token} → userId(正向映射,用于校验)</li>
|
|
|
|
|
|
* <li>xzg:refresh:user:{userId} → token(反向映射,用于登录时清除旧 token)</li>
|
|
|
|
|
|
* </ul>
|
|
|
|
|
|
* <p>TTL: 30 天,由 Redis 自动过期</p>
|
|
|
|
|
|
* <p>一个用户同一时间只保留一个有效的 refresh token,新登录会使旧 token 失效</p>
|
2026-06-16 18:20:11 +08:00
|
|
|
|
* <p>直接使用 StringRedisTemplate 存储纯字符串,避免 JSON 序列化导致的引号问题</p>
|
2026-06-16 16:02:09 +08:00
|
|
|
|
*/
|
|
|
|
|
|
@Slf4j
|
|
|
|
|
|
@Service
|
|
|
|
|
|
public class RefreshTokenServiceImpl implements RefreshTokenService {
|
|
|
|
|
|
|
|
|
|
|
|
/** Redis key 前缀 */
|
2026-06-16 18:20:11 +08:00
|
|
|
|
private static final String KEY_PREFIX = "xzg:refresh:";
|
2026-06-16 16:02:09 +08:00
|
|
|
|
|
|
|
|
|
|
/** 用户→token 反向映射 key 前缀 */
|
2026-06-16 18:20:11 +08:00
|
|
|
|
private static final String USER_KEY_PREFIX = "xzg:refresh:user:";
|
2026-06-16 16:02:09 +08:00
|
|
|
|
|
2026-06-16 18:20:11 +08:00
|
|
|
|
/** 刷新令牌有效期:30 天 */
|
|
|
|
|
|
private static final long EXPIRE_DAYS = 30;
|
2026-06-16 16:02:09 +08:00
|
|
|
|
|
|
|
|
|
|
/** 安全随机数生成器 */
|
|
|
|
|
|
private static final SecureRandom RANDOM = new SecureRandom();
|
|
|
|
|
|
|
2026-06-16 18:20:11 +08:00
|
|
|
|
private final StringRedisTemplate stringRedisTemplate;
|
|
|
|
|
|
|
|
|
|
|
|
public RefreshTokenServiceImpl(StringRedisTemplate stringRedisTemplate) {
|
|
|
|
|
|
this.stringRedisTemplate = stringRedisTemplate;
|
|
|
|
|
|
}
|
2026-06-16 16:02:09 +08:00
|
|
|
|
|
|
|
|
|
|
@Override
|
|
|
|
|
|
public String create(String userId) {
|
|
|
|
|
|
// 先清除该用户之前的 refresh token,确保一个用户只有一个有效 token
|
2026-06-16 18:20:11 +08:00
|
|
|
|
String oldToken = get(USER_KEY_PREFIX + userId);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
if (oldToken != null) {
|
2026-06-16 18:20:11 +08:00
|
|
|
|
delete(KEY_PREFIX + oldToken);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
log.debug("已清除旧的刷新令牌: userId={}", userId);
|
|
|
|
|
|
}
|
|
|
|
|
|
// 创建新 token
|
|
|
|
|
|
String token = generateToken();
|
2026-06-16 18:20:11 +08:00
|
|
|
|
log.debug("刷新令牌已生成: token={}", token);
|
|
|
|
|
|
set(KEY_PREFIX + token, userId);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
// 维护反向映射
|
2026-06-16 18:20:11 +08:00
|
|
|
|
set(USER_KEY_PREFIX + userId, token);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
log.debug("刷新令牌已创建: userId={}", userId);
|
|
|
|
|
|
return token;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
@Override
|
|
|
|
|
|
public String validate(String token) {
|
|
|
|
|
|
if (token == null || token.isBlank()) {
|
|
|
|
|
|
throw new BusinessException(ErrorCode.REFRESH_TOKEN_MISSING);
|
|
|
|
|
|
}
|
2026-06-16 18:20:11 +08:00
|
|
|
|
String userId = get(KEY_PREFIX + token);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
if (userId == null) {
|
|
|
|
|
|
throw new BusinessException(ErrorCode.REFRESH_TOKEN_INVALID);
|
|
|
|
|
|
}
|
|
|
|
|
|
return userId;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
@Override
|
|
|
|
|
|
public String rotate(String oldToken) {
|
|
|
|
|
|
String userId = validate(oldToken);
|
2026-06-16 18:20:11 +08:00
|
|
|
|
delete(KEY_PREFIX + oldToken);
|
|
|
|
|
|
delete(USER_KEY_PREFIX + userId);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
log.debug("旧刷新令牌已删除: userId={}", userId);
|
|
|
|
|
|
return create(userId);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
@Override
|
|
|
|
|
|
public void revoke(String token) {
|
|
|
|
|
|
if (token != null && !token.isBlank()) {
|
2026-06-16 18:20:11 +08:00
|
|
|
|
String userId = get(KEY_PREFIX + token);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
if (userId != null) {
|
2026-06-16 18:20:11 +08:00
|
|
|
|
delete(USER_KEY_PREFIX + userId);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
}
|
2026-06-16 18:20:11 +08:00
|
|
|
|
delete(KEY_PREFIX + token);
|
2026-06-16 16:02:09 +08:00
|
|
|
|
log.debug("刷新令牌已撤销");
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-06-16 18:20:11 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 写入字符串到 Redis(带过期时间)
|
|
|
|
|
|
*/
|
|
|
|
|
|
private void set(String key, String value) {
|
|
|
|
|
|
try {
|
|
|
|
|
|
stringRedisTemplate.opsForValue().set(key, value, EXPIRE_DAYS, TimeUnit.DAYS);
|
|
|
|
|
|
} catch (Exception e) {
|
|
|
|
|
|
log.error("刷新令牌写入 Redis 失败: key={}", key, e);
|
|
|
|
|
|
throw new BusinessException(ErrorCode.INTERNAL_ERROR, "刷新令牌操作失败");
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* 从 Redis 读取字符串(读取时续期)
|
|
|
|
|
|
*/
|
|
|
|
|
|
private String get(String key) {
|
|
|
|
|
|
try {
|
|
|
|
|
|
String value = stringRedisTemplate.opsForValue().get(key);
|
|
|
|
|
|
if (value != null) {
|
|
|
|
|
|
stringRedisTemplate.expire(key, EXPIRE_DAYS, TimeUnit.DAYS);
|
|
|
|
|
|
}
|
|
|
|
|
|
return value;
|
|
|
|
|
|
} catch (Exception e) {
|
|
|
|
|
|
log.error("查询缓存失败: key={}", key, e);
|
|
|
|
|
|
return null;
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* 从 Redis 删除 key
|
|
|
|
|
|
*/
|
|
|
|
|
|
private void delete(String key) {
|
|
|
|
|
|
try {
|
|
|
|
|
|
stringRedisTemplate.delete(key);
|
|
|
|
|
|
} catch (Exception e) {
|
|
|
|
|
|
log.error("删除缓存失败: key={}", key, e);
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-06-16 16:02:09 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 生成 64 位十六进制随机字符串作为刷新令牌
|
|
|
|
|
|
*/
|
|
|
|
|
|
private String generateToken() {
|
|
|
|
|
|
byte[] bytes = new byte[32];
|
|
|
|
|
|
RANDOM.nextBytes(bytes);
|
|
|
|
|
|
return HexFormat.of().formatHex(bytes);
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|