SYSTEM
第四步:角色权限系统
src/content/notes/blog-dev/第四步:角色权限系统.md 5. 第四步:角色权限系统
思路
在 JWT 鉴权(你是谁)基础上加授权(你能做什么),用 Spring Security 的 @PreAuthorize 实现方法级权限控制。
权限模型
┌────────────────────────────────────────────────┐
│ User 实体 │
│ id=1, username=admin, role=ADMIN │
│ id=2, username=test1, role=USER │
└─────────────────┬──────────────────────────────┘
│ 登录
▼
┌────────────────────────────────────────────────┐
│ JWT Token Payload │
│ { "sub": "1", "role": "ADMIN", "exp": ... } │
└─────────────────┬──────────────────────────────┘
│ 请求
▼
┌────────────────────────────────────────────────┐
│ UserPrincipal.getAuthorities() │
│ ADMIN → [ SimpleGrantedAuthority("ROLE_ADMIN") ] │
│ USER → [ SimpleGrantedAuthority("ROLE_USER") ] │
└─────────────────┬──────────────────────────────┘
│ 匹配
▼
┌─────────────────────────────────────────────────┐
│ @PreAuthorize("hasRole('ADMIN')") │
│ hasRole('ADMIN') → 自动拼前缀 → 匹配 ROLE_ADMIN │
│ 匹配成功 → 放行 匹配失败 → 403 Forbidden │
└─────────────────────────────────────────────────┘
关键代码
枚举设计 — 数据库存简短值,转换层加前缀:
// 数据库存: "USER" / "ADMIN"(干净)
public enum Role { USER, ADMIN }
// getAuthorities() 加前缀: "ROLE_USER" / "ROLE_ADMIN"(Spring Security 约定)
return List.of(new SimpleGrantedAuthority("ROLE_" + role));
前后端双重防护:
| 防护层 | 作用 | 绕过难度 |
|---|---|---|
前端路由守卫 requiresAdmin |
普通用户看不到入口 | 容易(手动输 URL) |
后端 @PreAuthorize |
即使绕过前端,服务端拒绝 | 极难(需要伪造 JWT 签名) |
优化经验
| 问题 | 优化方式 |
|---|---|
枚举名 ROLE_ADMIN 语义重复 |
枚举用 ADMIN,转换层加 ROLE_ 前缀 |
| 所有登录用户都能改网站配置 | saveConfig/deleteConfig 加 @PreAuthorize("hasRole('ADMIN')") |
| 前端不区分角色,所有人看到同样界面 | isAdmin 计算属性 + 路由守卫 + 组件级校验 |