Spring Cache无参方法能否使用安全上下文当前认证用户作为缓存键？

你的核心思路是合理的：无参业务方法按用户维度隔离缓存，用当前登录用户ID作为缓存键的逻辑没有问题，但你写的现有代码无法正常运行，存在核心缺陷。

存在的问题 #

• @Cacheable注解的SpEL表达式默认只能读取方法入参作为上下文变量，你当前的方法没有任何入参，所以表达式里的#userPrincipal属于不存在的变量，运行时会直接抛出SpEL变量解析异常，不会进入业务逻辑执行。

正确实现方案 #

方案1：SpEL直接调用静态方法获取安全上下文 #

Spring SpEL支持直接调用类的静态方法，你可以直接从Spring Security提供的全局安全上下文获取认证信息，写法如下：

// 兼容匿名用户场景的写法
@Cacheable(value = "resultCache", key = "T(org.springframework.security.core.context.SecurityContextHolder).getContext().getAuthentication()?.getPrincipal()?.id ?: 'anonymous'")
public Result getResult() {}

如果你的业务要求该方法必须登录才能调用，不需要兼容匿名访问，可以去掉安全调用符和默认值，未登录时直接抛出异常也符合预期。

方案2：自定义缓存键生成器（适合多场景复用） #

如果项目中存在大量需要按用户维度缓存的无参方法，建议自定义KeyGenerator统一处理逻辑，避免重复写长串SpEL：

1. 实现自定义键生成器

@Component
public class UserIdKeyGenerator implements KeyGenerator {
    @Override
    public Object generate(Object target, Method method, Object... params) {
        Authentication auth = SecurityContextHolder.getContext().getAuthentication();
        // 处理未登录/匿名登录场景
        if (auth == null || !auth.isAuthenticated() || auth.getPrincipal() instanceof String) {
            return "anonymous:" + method.getName();
        }
        // 替换为你自己的Principal实现类
        UserPrincipal principal = (UserPrincipal) auth.getPrincipal();
        return method.getName() + ":" + principal.getId();
    }
}

2. 在注解中指定使用该生成器

@Cacheable(value = "resultCache", keyGenerator = "userIdKeyGenerator")
public Result getResult() {}

注意事项 #

• 提前确认你的Principal实现类确实存在getId方法，且认证成功后Spring Security上下文存储的Principal就是你自定义的类型，避免出现类型转换异常
• 如果方法会被异步线程调用，需要提前配置Spring Security的上下文传递策略，否则异步线程无法获取到当前登录用户的认证信息，会生成错误的缓存键

内容的提问来源于stack exchange，提问作者Png