P1-1 · JWT 缩短有效期 + Refresh Token + 黑名单 2h · 规范 R5.2 / R6.2
涉及文件
| 文件 | 操作 |
drama-common/.../utils/JwtUtil.java | 修改 |
drama-common/.../utils/JwtRefreshUtil.java | 新建 |
drama-gateway/.../filter/JwtAuthFilter.java | 修改 |
drama-common/.../entity/RefreshToken.java | 新建 |
实施步骤
Step 1 — 缩短 Access Token,新增 Refresh Token
当前 JwtUtil.java:35:
private static final long EXPIRE = 7 * 24 * 60 * 60 * 1000L; // 7 天
修改为:
// Access Token: 2 小时
private static final long ACCESS_EXPIRE = 2 * 60 * 60 * 1000L;
// Refresh Token: 7 天(轮换制)
private static final long REFRESH_EXPIRE = 7 * 24 * 60 * 60 * 1000L;
Step 2 — 新增 Refresh 端点
POST /api/user/auth/refresh
Header: Authorization: Bearer <refresh_token>
→ 返回 { accessToken, refreshToken, expiresIn }
Step 3 — JwtAuthFilter Redis 黑名单
@Scheduled(fixedRate = 60_000)
public void refreshBlacklist() {
blacklist = redisTemplate.opsForSet().members("jwt:blacklist");
}
if (blacklist.contains(token)) {
return Mono.error(new UnauthorizedException("Token 已被吊销"));
}
Step 4 — 登出接口
POST /api/user/logout
→ 当前 Access Token + Refresh Token 加入 Redis 黑名单
P1-3 · Commit 规范 + 分支策略 1h · 规范 R7.1 / R7.2
Step 1 — 配置远端仓库
git remote add origin <remote-url>
Step 2 — 分支策略
main ← 生产就绪,仅从 release/hotfix 合并
├── develop ← 日常集成分支
├── feature/* ← 功能分支,从 develop 拉取
├── release/* ← 发布分支
└── hotfix/* ← 紧急修复
Step 3 — CONTRIBUTING.md
必须使用 Conventional Commits:
feat(coin): 添加签到领取金币功能
fix(payment): 修复支付回调签名验证
docs(api): 补充商品卡片接口文档
refactor(user): 移除 SpreeClient
test(trade): 添加并发支付测试
chore(deps): 升级 spring-boot 至 3.2.6
P2-1 · CI 流水线搭建 4h · 规范 R7.4
流水线阶段(GitLab CI)
stages:
- lint # mvn checkstyle:check
- test # mvn test + jacoco:report
- security # dependency-check
- build # mvn package
- docker # build + push(仅 main)
Dockerfile
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app
COPY target/*.jar app.jar
EXPOSE 810x
ENTRYPOINT ["java", "-jar", "app.jar"]
门禁规则
| 门禁 | 通过条件 |
| MR → develop | lint + test 通过 |
| MR → main | lint + test + security + build 通过 |
| main tag 触发 | 全流水线 + docker push |
P2-2 · 审计日志补齐 4h · 规范 R8.4
全局审计日志表
CREATE TABLE t_audit_log (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
operator_id BIGINT NOT NULL,
operator_type VARCHAR(20),
action VARCHAR(50) NOT NULL,
target_type VARCHAR(50),
target_id VARCHAR(64),
detail JSON,
ip_address VARCHAR(45),
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
AuditLogService
@Service
@RequiredArgsConstructor
public class AuditLogService {
private final AuditLogMapper auditLogMapper;
@Async("auditLogExecutor")
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void record(Long operatorId, String operatorType, String action,
String targetType, String targetId, Object detail) {
AuditLog log = AuditLog.builder()
.operatorId(operatorId).operatorType(operatorType)
.action(action).targetType(targetType).targetId(targetId)
.detail(JsonUtils.toJson(detail))
.ipAddress(IpUtil.getCurrentRequestIp()).build();
auditLogMapper.insert(log);
}
}
8 个注入点
| 场景 | 位置 | Action |
| CP 审核 | UserController.reviewCp() | CP_REVIEW_APPROVE/REJECT |
| 用户封禁/解封 | UserController.banUser() | USER_BAN/UNBAN |
| 内容上架/下架 | ContentController.audit() | CONTENT_PUBLISH/UNPUBLISH |
| 金币充值 | CoinController.recharge() | COIN_RECHARGE |
| 提现审批 | WalletController.withdraw() | WITHDRAW_APPROVE/REJECT |
| 广告位配置变更 | AdController.updatePlacement() | AD_PLACEMENT_UPDATE |
| 提现档位变更 | WithdrawConfigController.update() | WITHDRAW_CONFIG_UPDATE |
| 支付费率变更 | PaymentController.updateRate() | PAYMENT_RATE_UPDATE |