SYSTEM
增加角色系统
src/content/notes/blog-dev/增加角色系统.md 增加角色系统
目前项目只有 JWT 鉴权(你是谁),没有授权(你能做什么)。加一个简单的角色系统,就能区分普通用户和管理员。
一、完整修正方案(6 个文件)
第 1 步:User 实体加 role 字段
修改 User.java:
@Entity
@Table(name = "user")
public class User {
// ... 现有字段不变
@Enumerated(EnumType.STRING)
@Column(nullable = false, length = 20)
private Role role = Role.USER; // 默认普通用户
public enum Role {
USER,
ADMIN
}
}
修改UserController.java:
String token = jwtUtil.generateToken(loggedInUser.getId(), loggedInUser.getRole().name());
@PostMapping("/login")
public Result<Map<String, Object>> login(@RequestBody User loginRequest) {
User loggedInUser = userService.login(loginRequest.getUsername(), loginRequest.getPassword());
String token = jwtUtil.generateToken(loggedInUser.getId(), loggedInUser.getRole().name());
Map<String, Object> data = new HashMap<>();
data.put("user", loggedInUser);
data.put("token", token);
return Result.success(data);
}
注意:loginRequest 是前端请求对象,loggedInUser 是数据库查出来的完整用户。
第 2 步:UserPrincipal 改造
修改 UserPrincipal.java:
@Getter
@ToString
@EqualsAndHashCode
public class UserPrincipal implements UserDetails {
private static final long serialVersionUID = 1L;
private final Long userId;
private final String role;
public UserPrincipal(Long userId, String role) {
this.userId = userId;
this.role = role;
}
@Override
public Collection<? extends GrantedAuthority> getAuthorities() {
// 关键:Spring Security 约定角色前缀 ROLE_
// 数据库存 USER/ADMIN,这里加前缀变成 ROLE_USER / ROLE_ADMIN
return List.of(new SimpleGrantedAuthority("ROLE_" + role));
}
//..剩下不变
}
第 3 步:JwtUtil 加方法
修改 JwtUtil.java:
3.1 generateToken 加 role 参数
public String generateToken(Long userId, String role) {
return Jwts.builder()
.subject(userId.toString())
.claim("role", role) // 新增:存角色
.issuedAt(new Date())
.expiration(new Date(System.currentTimeMillis() + expirationTime))
.signWith(key)
.compact();
}
3.2 加 getRoleFromToken
public String getRoleFromToken(String token) {
Claims claims = Jwts.parser()
.verifyWith(key)
.build()
.parseSignedClaims(token)
.getPayload();
return claims.get("role", String.class);
}
第 4 步:JwtAuthenticationFilter 解析 role
修改 JwtAuthenticationFilter.java 第 51-53 行:
// 3. token 有效 → 解析 userId + role,构造认证信息
Long userId = jwtUtil.getUserIdFromToken(token);
String role = jwtUtil.getRoleFromToken(token); // 新增
UserPrincipal principal = new UserPrincipal(userId, role);
第 5 步:UserServiceImpl 联动改
5.1 register 里设默认角色
user.setRole(User.Role.USER); // 新注册都是普通用户
5.2 login 里 generateToken 传 role
// 改前
String token = jwtUtil.generateToken(user.getId());
// 改后
String token = jwtUtil.generateToken(user.getId(), user.getRole().name());
第 6 步:给接口加权限注解
6.1 BloomFilterController 落地 TODO
修改 BloomFilterController.java 第 34 行:
// 改前
//TODO: 加上 @PreAuthorize("hasRole('ADMIN')")
// 改后
@PreAuthorize("hasRole('ADMIN')")
所有三个接口(stats、rebuild、check)都是管理员接口,可以在类级别加:
@RestController
@RequestMapping("/api/admin/bloom")
@PreAuthorize("hasRole('ADMIN')") // ← 类级别,所有方法都要管理员
public class BloomFilterController {
// ...
}
6.2 文章管理接口(可选)
ArticleController.java的 update / delete 也应该限制:
@PutMapping("/update/{id}")
@PreAuthorize("hasRole('ADMIN')") // 只有管理员能改任何文章
public Result<Article> updateArticle(...) { ... }
@DeleteMapping("/delete/{id}")
@PreAuthorize("hasRole('ADMIN')")
public Result<String> deleteArticle(...) { ... }
注意:create 接口普通用户也能发文章,不用加。
四、数据库迁移
你数据库里已经有用户了,需要加列并赋默认值:
ALTER TABLE user ADD COLUMN role VARCHAR(20) NOT NULL DEFAULT 'USER';
创建管理员账号
直接在数据库里改一条:
UPDATE user SET role = 'ADMIN' WHERE username = '你的管理员用户名';
五、思考
1.”为什么前端拦了,后端还要拦?“——这是前后端双重校验的安全设计:
| 防护层 | 作用 | 绕过难度 |
|---|---|---|
| 前端路由守卫 | 普通用户看不到入口,体验更好 | 容易(手动输 URL) |
后端 @PreAuthorize |
即使绕过前端,服务端拒绝 | 极难(需要 JWT 签名密钥) |
2.前端请求拦截 + 后端安全过滤链 + 前端路由守卫三层机制,实现登录前后的网络配置差异。
| 防护层 | 作用位置 | 控制什么 |
|---|---|---|
| 前端路由守卫 | Vue Router beforeEach | 哪些页面能进 |
| 前端请求拦截 | api/index.js request() | 请求是否带 token |
| 后端 Security Filter Chain | Spring Security | 接口是否有权限访问 |
后端安全层:放行 vs 拦截
核心文件:SecurityConfig.java + JwtAuthenticationFilter.java
后端的请求处理流程:
请求到达
│
▼
┌────────────────────┐
│ JwtAuthentication │
│ Filter │
└─────────┬──────────┘
│
┌────────────┴────────────┐
│ 有 token 且有效? │
└────┬──────────────┬─────┘
是 │ │ 否(无 token / 无效)
▼ ▼
┌────────────────┐ 放行(匿名状态)
│ 写入 Security │ │
│ Context │ │
│ (带用户身份) │ │
└───────┬────────┘ │
└───────┬───────┘
▼
┌─────────────────────┐
│ SecurityConfig │
│ authorizeRequests │
└─────────┬───────────┘
│
┌────────────┴─────────────┐
│ 路径在 permitAll 列表? │
└─────┬───────────────┬───┘
是 │ │ 否
▼ ▼
直接放行 检查是否已认证
┌──────┴──────┐
是 │ │ 否
▼ ▼
进入Controller 返回 401
3.项目深度依赖 Spring Security,只是走的是企业级自定义认证而非默认用户:
| 功能 | 你的实现 | 所在文件 |
|---|---|---|
| 请求过滤链 | JwtAuthenticationFilter 拦截所有请求 |
JwtAuthenticationFilter.java |
| URL 权限控制 | permitAll() / authenticated() / @PreAuthorize |
SecurityConfig.java |
| 安全上下文 | SecurityContextHolder.setAuthentication() |
JwtAuthenticationFilter.java |
| 方法级授权 | @PreAuthorize("hasRole('ADMIN')") |
SiteConfigController.java |
| 密码加密 | BCryptPasswordEncoder |
SecurityConfig.java |
| 异常处理 | AuthenticationEntryPoint 统一返回 401 |
SecurityAuthenticationEntryPoint.java |
你用的是 Spring Security 的核心能力,只是认证数据源从”内存默认用户”换成了”JWT Token + 数据库用户表”。
面试话术
“我在 JWT 鉴权基础上加了角色授权体系。用枚举定义 USER 和 ADMIN 两个角色,存在 user 表的 role 字段。登录时把 role 放进 JWT 的 claim,JWT 过滤器解析后构造
UserPrincipal,getAuthorities()返回ROLE_前缀的权限对象。接口层面用@PreAuthorize("hasRole('ADMIN')")做方法级权限控制。设计要点:ROLE_前缀是 Spring Security 的约定,所以在转换层加前缀而不是存在数据库里,保持数据干净。”