Spring Security JWT 逐用户权限如何避免每请求两次查库?
明确结论 不要把 JPA 的 User 实体当作 Authentication 的 principal 跨层传递。过滤器只负责解析 JWT 并加载轻量认证信息,比如 userId、email 和 authorities;业务 service 要修改用户时,在自己的 @Transactional 事务里按 userId 或 email 重新加载实体。权限查询尽量走缓存,减少 DB 访问。缓存命中时,业务请求通常只会查一次用户。如果权限必须实时生效、不能缓存,那每次请求的权限查询无法完全避免;但可以避免因为跨层传递 detached 实体而多出来的用户查询。
为什么会出现两次查询 在过滤器里用 userRepository.findByEmail(…) 查出来的 User 实体,离开 repository 方法后通常已经 detached。detached 实体不能安全地修改后自动 flush,也不能可靠地访问懒加载关联。用 save 或 merge 处理 detached 实体时,Hibernate 仍可能先 select 再合并,还有覆盖并发修改的风险。不要把 OpenEntityManagerInView 当作把实体强行保持到 service 层的办法,这会让事务边界和懒加载行为更难控制。
推荐结构
- 使用轻量 principal。Authentication 里只放身份标识和权限,不要放带懒加载集合的 JPA 实体。
public record AuthenticatedUser(
Long id,
String email,
Collection<GrantedAuthority> authorities
) {}
- 过滤器只解析 JWT 并建立认证信息。权限可以从缓存取,缓存未命中再查 DB。
String email = jwtService.extractEmail(token);
AuthenticatedUser principal = authService.loadLightweight(email);
var auth = new UsernamePasswordAuthenticationToken(
principal, null, principal.authorities());
SecurityContextHolder.getContext().setAuthentication(auth);
这里的 loadLightweight 返回 id、email 和权限字符串就够了,不要返回完整 User 实体。hasAuthority(…) 使用的权限字符串必须和 Authentication 里的 authority 完全一致;hasRole(…) 会自动加 ROLE_ 前缀,两者不要混用。
- Service 在事务内重新加载实体再修改。这是业务事务自己的边界,不能拿过滤器里的实体直接改。
@Transactional
public void updateProfile(Long userId, String nickname) {
User user = userRepository.findById(userId).orElseThrow();
user.setNickname(nickname);
}
- Controller 从 principal 取 userId 或 email,然后调用 service。
@PreAuthorize("hasAuthority('USER_UPDATE')")
@PutMapping("/profile")
public void updateProfile(@AuthenticationPrincipal AuthenticatedUser principal,
@RequestBody ProfileRequest request) {
userService.updateProfile(principal.id(), request.nickname());
}
- 对每个请求都要用的权限做缓存。比如用 Caffeine 或 Redis 缓存用户权限;权限变更时主动清缓存,并设置合理的 TTL 兜底。
@Cacheable(cacheNames = "userAuthorities", key = "#email")
public Collection<GrantedAuthority> loadAuthorities(String email) {
return userRepository.findAuthoritiesByEmail(email);
}
@CacheEvict(cacheNames = "userAuthorities", key = "#email")
public void evictAuthorities(String email) {}
这样拆分后,认证阶段可能只读缓存里的权限;业务修改阶段在事务内查一次 User。若缓存未命中,仍然是权限查询加业务查询。这是权限实时性和性能之间的取舍,不是跨层传递 detached 实体造成的重复查询。
注意事项
- 不要把 User 实体放进 SecurityContext 后还指望它在 service 层可修改。事务结束后实体已经 detached,后续修改不会自动保存。
- 不建议为了复用过滤器里的实体就用 merge 代替正常加载。merge 可能多触发一次 select,也可能覆盖未提交字段。
- 权限缓存必须有失效策略:权限变更、用户删除、角色调整时清掉对应缓存;多实例部署时用集中缓存或失效广播。
- 如果安全要求权限变更立即生效且不允许缓存,那就接受每次请求查一次权限;但仍应使用轻量 principal,在业务事务里再查 User。
- JWT 里可以放 userId、email 或权限版本号,但不要把具体权限规则暴露到 token 中。服务端按用户标识和版本号加载或失效权限缓存。
备注:内容仅供参考。
