← 返回学习路线

SYSTEM

第四步:角色权限系统

博客系统工程5. 第四步:角色权限系统blog-dev
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 计算属性 + 路由守卫 + 组件级校验